@tauri-apps/plugin-http

使用 Rust 后端进行 HTTP 请求。

安全

此 API 具有作用域配置，强制您使用 glob 模式限制可访问的 URL。

例如，此作用域配置仅允许对 tauri.app 的所有子域进行 HTTP 请求，但 https://private.tauri.app 除外

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

尝试执行任何未在作用域中配置 URL 的 API 将因拒绝访问而导致 Promise 拒绝。

接口

ClientOptions

配置用于发出 fetch 请求的 Rust 客户端的选项

始于

2.0.0

属性

属性	类型	描述	定义于
connectTimeout?	数字	超时时间（毫秒）	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L82
danger?	DangerousSettings	客户端危险设置的配置，例如禁用 SSL 验证。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L90
maxRedirections?	数字	定义客户端应遵循的最大重定向次数。如果设置为 0，则不遵循任何重定向。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L80
proxy?	Proxy	客户端应将请求传递给的代理配置。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L86

---

DangerousSettings

客户端危险设置的配置，例如禁用 SSL 验证。

始于

2.3.0

属性

属性	类型	描述	定义于
acceptInvalidCerts?	布尔值 (boolean)	禁用 SSL 验证。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L102
acceptInvalidHostnames?	布尔值 (boolean)	禁用主机名验证。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L106

---

Proxy

客户端应将请求传递给的代理配置。

始于

2.0.0

属性

属性	类型	描述	定义于
all?	string | ProxyConfig	将所有流量代理到传递的 URL。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L40
http?	string | ProxyConfig	将所有 HTTP 流量代理到传递的 URL。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L44
https?	string | ProxyConfig	将所有 HTTPS 流量代理到传递的 URL。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L48

---

ProxyConfig

属性

属性	类型	描述	定义于
basicAuth?	对象	使用 Basic 身份验证设置 Proxy-Authorization 标头。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L59
basicAuth.password	字符串	-	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L61
basicAuth.username	字符串	-	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L60
noProxy?	字符串	用于过滤不应代理的请求的配置。条目应以逗号分隔（条目之间的空格将被忽略）	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L67
url	字符串	代理服务器的 URL。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L55

函数

fetch()

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

从网络获取资源。它返回一个 Promise，该 Promise 解析为对该 Request 的 Response，无论成功与否。

参数

参数	类型
输入	string | URL | Request
初始化?	RequestInit & ClientOptions

返回

Promise<Response>

示例

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();

始于

2.0.0

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