HTTP クライアント

GitHub npm crates.io

API Reference

http プラグインを使用して HTTP リクエストを行います。

サポートされているプラットフォーム

This plugin requires a Rust version of at least 1.77.2

Platform	Level	Notes
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 プラグインは、reqwest の再エクスポートとして Rust で、また 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';
   
   // GET リクエストを送信する
   const response = await fetch('http://test.tauri.app/data.json', {
     method: 'GET',
   });
   console.log(response.status); // 例: 200
   console.log(response.statusText); // 例: "OK"

   ノート

   禁止されたリクエストヘッダーはデフォルトで無視されます。それらを使用するには、unsafe-headers 機能フラグを有効にする必要があります：

   src-tauri/Cargo.toml

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

Rust

Rust では、プラグインによって再エクスポートされた reqwest クレートを利用できます。詳細については、reqwest のドキュメントを参照してください。

use tauri_plugin_http::reqwest;

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

Default Permission

This permission set configures what kind of fetch operations are available from the http plugin.

This enables all fetch operations but does not allow explicitly any origins to be fetched. This needs to be manually configured before usage.

Granted Permissions

All fetch operations are enabled.

This default permission set includes the following:

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

Permission Table

Identifier	Description
http:allow-fetch	Enables the fetch command without any pre-configured scope.
http:deny-fetch	Denies the fetch command without any pre-configured scope.
http:allow-fetch-cancel	Enables the fetch_cancel command without any pre-configured scope.
http:deny-fetch-cancel	Denies the fetch_cancel command without any pre-configured scope.
http:allow-fetch-read-body	Enables the fetch_read_body command without any pre-configured scope.
http:deny-fetch-read-body	Denies the fetch_read_body command without any pre-configured scope.
http:allow-fetch-send	Enables the fetch_send command without any pre-configured scope.
http:deny-fetch-send	Denies the fetch_send command without any pre-configured scope.