@tauri-apps/plugin-http

Realiza peticiones HTTP con el backend de Rust.

Seguridad

Esta API tiene una configuración de alcance que te obliga a restringir las URL a las que se puede acceder utilizando patrones glob.

Por ejemplo, esta configuración de alcance solo permite realizar peticiones HTTP a todos los subdominios de tauri.app excepto a https://private.tauri.app:

{
  "permissions": [
    {
      "identifier": "http:default",
      "allow": [{ "url": "https://*.tauri.app" }],
      "deny": [{ "url": "https://private.tauri.app" }]
    }
  ]
}

Intentar ejecutar cualquier API con una URL no configurada en el alcance resulta en un rechazo de la promesa debido a acceso denegado.

Interfaces

ClientOptions

Opciones para configurar el cliente de Rust utilizado para realizar peticiones fetch

Desde

2.0.0

Propiedades

Propiedad	Tipo	Descripción	Definido en
connectTimeout?	number	Tiempo de espera en milisegundos	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L82
danger?	DangerousSettings	Configuración para ajustes peligrosos en el cliente, como desactivar la verificación SSL.	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L90
maxRedirections?	number	Define el número máximo de redirecciones que el cliente debe seguir. Si se establece en 0, no se seguirá ninguna redirección.	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L80
proxy?	Proxy	Configuración de un proxy al que un Client debe pasar las peticiones.	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L86

---

DangerousSettings

Configuración para ajustes peligrosos en el cliente, como desactivar la verificación SSL.

Desde

2.3.0

Propiedades

Propiedad	Tipo	Descripción	Definido en
acceptInvalidCerts?	boolean	Desactiva la verificación SSL.	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L102
acceptInvalidHostnames?	boolean	Desactiva la verificación del nombre de host.	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L106

---

Proxy

Configuración de un proxy al que un Client debe pasar las peticiones.

Desde

2.0.0

Propiedades

Propiedad	Tipo	Descripción	Definido en
all?	string | ProxyConfig	Redirige todo el tráfico a través de proxy a la URL indicada.	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L40
http?	string | ProxyConfig	Redirige todo el tráfico HTTP a través de proxy a la URL indicada.	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L44
https?	string | ProxyConfig	Redirige todo el tráfico HTTPS a través de proxy a la URL indicada.	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L48

---

ProxyConfig

Propiedades

Propiedad	Tipo	Descripción	Definido en
basicAuth?	object	Establece el encabezado Proxy-Authorization usando autenticación Basic.	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L59
basicAuth.password	string	-	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L61
basicAuth.username	string	-	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L60
noProxy?	string	Una configuración para filtrar las peticiones que no deben pasar por proxy. Se espera que las entradas estén separadas por comas (se ignoran los espacios en blanco entre entradas)	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L67
url	string	La URL del servidor proxy.	Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L55

Funciones

fetch()

function fetch(input, init?): Promise<Response>

Obtiene un recurso de la red. Devuelve una Promise que se resuelve a la Response de esa Request, ya sea exitosa o no.

Parámetros

Parámetro	Tipo
input	string | URL | Request
init?	RequestInit & ClientOptions

Devuelve

Promise<Response>

Ejemplo

const response = await fetch("http://my.json.host/data.json");
console.log(response.status);  // e.g. 200
console.log(response.statusText); // e.g. "OK"
const jsonData = await response.json();

Desde

2.0.0

Fuente: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L125