HTTP 客户端

GitHub npm crates.io

API 参考

使用 http 插件发出 HTTP 请求。

支持的平台

此插件需要至少 1.77.2 版本的 Rust

平台	级别	注释
windows
linux
macos
android
ios

设置

安装 http 插件即可开始。

自动

使用项目的包管理器添加依赖项

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

手动

1. 在 src-tauri 文件夹中运行以下命令，将插件添加到 Cargo.toml 项目的依赖项中

   cargo add tauri-plugin-http

2. 修改 lib.rs 以初始化插件

   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. 如果要在 JavaScript 中发出 http 请求，请同时安装 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

用法

HTTP 插件在 Rust 中以 reqwest 重新导出和 JavaScript 两种形式提供。

JavaScript

1. 配置允许的 URL

   src-tauri/capabilities/default.json

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

   有关更多信息，请参阅 权限概述 的文档

2. 发送请求

   fetch 方法力求尽可能接近并符合 fetch Web API。

   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"

   注意

   禁止的请求标头 默认情况下会被忽略。 要使用它们，您必须启用 unsafe-headers 功能标志

   src-tauri/Cargo.toml

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

Rust

在 Rust 中，您可以使用插件重新导出的 reqwest crate。 有关更多详细信息，请参阅 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 }")

默认权限

此权限集配置了 http 插件中可用的 fetch 操作类型。

这将启用所有 fetch 操作，但不显式允许任何源被获取。 这需要在使用前手动配置。

已授予的权限

所有 fetch 操作均已启用。

此默认权限集包括以下内容

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

权限表

标识符	描述
http:allow-fetch	启用 fetch 命令，无需任何预配置的作用域。
http:deny-fetch	禁用 fetch 命令，无需任何预配置的作用域。
http:allow-fetch-cancel	启用 fetch_cancel 命令，无需任何预配置的作用域。
http:deny-fetch-cancel	禁用 fetch_cancel 命令，无需任何预配置的作用域。
http:allow-fetch-read-body	启用 fetch_read_body 命令，无需任何预配置的作用域。
http:deny-fetch-read-body	禁用 fetch_read_body 命令，无需任何预配置的作用域。
http:allow-fetch-send	启用 fetch_send 命令，无需任何预配置的作用域。
http:deny-fetch-send	禁用 fetch_send 命令，无需任何预配置的作用域。