@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" }]
    }
  ]
}

尝试执行任何 API，如果 URL 未在作用域中配置，则会导致 promise 拒绝，因为访问被拒绝。

接口

ClientOptions

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

始于

2.0.0

属性

属性	类型	描述	定义于
connectTimeout?	number	超时时间，单位为毫秒	来源: 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?	number	定义客户端应遵循的最大重定向次数。如果设置为 0，则不遵循任何重定向。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L80
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

---

代理

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

始于

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?	object	使用 Basic auth 设置 Proxy-Authorization 标头。	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L59
basicAuth.password	string	-	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L61
basicAuth.username	string	-	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L60
noProxy?	string	用于过滤掉不应被代理的请求的配置。条目应以逗号分隔（条目之间的空格将被忽略）	来源: https://github.com/tauri-apps/plugins-workspace/blob/v2/plugins/http/guest-js/index.ts#L67
url	string	代理服务器的 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，无论是否成功。

参数

参数	类型
input	string | URL | Request
init?	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