Cliente HTTP

GitHubnpmcrates.io

Referencia de API

Realiza peticiones HTTP con el plugin http.

Plataformas Soportadas

Este plugin requiere una versión de Rust de al menos 1.77.2

Plataforma	Nivel	Notas
windows
linux
macos
android
ios

Configuración

Instala el plugin http para comenzar.

Automático

Usa el gestor de paquetes de tu proyecto para agregar la dependencia:

npm

npm run tauri add http

yarn

yarn run tauri add http

pnpm

pnpm tauri add http

deno

deno task tauri add http

bun

bun tauri add http

cargo

cargo tauri add http

Manual

1. Ejecuta el siguiente comando en la carpeta src-tauri para agregar el plugin a las dependencias del proyecto en Cargo.toml:

   cargo add tauri-plugin-http

2. Modifica lib.rs para inicializar el plugin:

   src-tauri/src/lib.rs

   #[cfg_attr(mobile, tauri::mobile_entry_point)]
   pub fn run() {
       tauri::Builder::default()
           .plugin(tauri_plugin_http::init())
           .run(tauri::generate_context!())
           .expect("error while running tauri application");
   }

3. Si deseas realizar peticiones HTTP en JavaScript, instala también el paquete de npm:

   npm

   npm install @tauri-apps/plugin-http

   yarn

   yarn add @tauri-apps/plugin-http

   pnpm

   pnpm add @tauri-apps/plugin-http

   deno

   deno add npm:@tauri-apps/plugin-http

   bun

   bun add @tauri-apps/plugin-http

Uso

El plugin HTTP está disponible tanto en Rust como una reexportación de reqwest como en JavaScript.

JavaScript

1. Configura las URL permitidas

   src-tauri/capabilities/default.json

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

   Para más información, consulta la documentación sobre la Visión General de Permisos

2. Envía una petición

   El método fetch intenta ser lo más cercano y compatible posible con la API Web fetch.

   import { fetch } from '@tauri-apps/plugin-http';
   
   // Send a GET request
   const response = await fetch('http://test.tauri.app/data.json', {
     method: 'GET',
   });
   console.log(response.status); // e.g. 200
   console.log(response.statusText); // e.g. "OK"

   Nota

   Los encabezados de petición prohibidos se ignoran por defecto. Para utilizarlos debes habilitar el feature flag unsafe-headers:

   src-tauri/Cargo.toml

   [dependencies]
   tauri-plugin-http = { version = "2", features = ["unsafe-headers"] }

Rust

En Rust puedes utilizar el crate reqwest reexportado por el plugin. Para más detalles consulta la documentación de reqwest.

use tauri_plugin_http::reqwest;

let res = reqwest::get("http://my.api.host/data.json").await;
println!("{:?}", res.status()); // e.g. 200
println!("{:?}", res.text().await); // e.g Ok("{ Content }")

Permiso Predeterminado

Este conjunto de permisos configura qué tipo de operaciones de fetch están disponibles desde el plugin http.

Esto habilita todas las operaciones de fetch pero no permite explícitamente el envío a ningún origen. Esto debe configurarse manualmente antes de su uso.

Permisos Otorgados

Todas las operaciones de fetch están habilitadas.

Este conjunto de permisos predeterminado incluye lo siguiente:

• allow-fetch
• allow-fetch-cancel
• allow-fetch-send
• allow-fetch-read-body
• allow-fetch-cancel-body

Tabla de Permisos

Identificador	Descripción
http:allow-fetch	Habilita el comando fetch sin ningún alcance preconfigurado.
http:deny-fetch	Deniega el comando fetch sin ningún alcance preconfigurado.
http:allow-fetch-cancel	Habilita el comando fetch_cancel sin ningún alcance preconfigurado.
http:deny-fetch-cancel	Deniega el comando fetch_cancel sin ningún alcance preconfigurado.
http:allow-fetch-cancel-body	Habilita el comando fetch_cancel_body sin ningún alcance preconfigurado.
http:deny-fetch-cancel-body	Deniega el comando fetch_cancel_body sin ningún alcance preconfigurado.
http:allow-fetch-read-body	Habilita el comando fetch_read_body sin ningún alcance preconfigurado.
http:deny-fetch-read-body	Deniega el comando fetch_read_body sin ningún alcance preconfigurado.
http:allow-fetch-send	Habilita el comando fetch_send sin ningún alcance preconfigurado.
http:deny-fetch-send	Deniega el comando fetch_send sin ningún alcance preconfigurado.