HTTP Client（HTTP クライアント）

《訳注》

Plugin 説明内容の英語表記部分について　Plugin の各章は、原文データからページ内容の一部が自動生成されているため、英語表記のままの部分があります。

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 run tauri add http

yarn run tauri add http

pnpm tauri add http

deno task tauri add http

bun tauri add http

cargo tauri add http

src-tauri フォルダで次のコマンドを実行して、このプラグインを Cargo.toml 内のプロジェクトの依存関係に追加します：
```
cargo add tauri-plugin-http
```

追加したプラグインを初期化するために 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");
}

JavaScript で http リクエストを行なう場合は、npm パッケージもインストールします：

npm install @tauri-apps/plugin-http

yarn add @tauri-apps/plugin-http

pnpm add @tauri-apps/plugin-http

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

bun add @tauri-apps/plugin-http

使用法

「HTTP」プラグインは、JavaScrip と reqwest の再エクスポート（re-export）としての Rust の両方で利用可能です。

JavaScript

許可されたURLを設定します

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

詳細については、アクセス権の概要のドキュメントをご覧ください。

リクエストの送信

「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()); // e.g. 200
println!("{:?}", res.text().await); // e.g 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-send
allow-fetch-read-body
allow-fetch-cancel-body

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-cancel-body`	Enables the fetch_cancel_body command without any pre-configured scope.
`http:deny-fetch-cancel-body`	Denies the fetch_cancel_body 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.

【※ この日本語版は、「Feb 22, 2025 英語版」に基づいています】

Support on Open Collective Sponsor on GitHub