HTTP Client

Make HTTP requests with the http plugin.

Supported Platforms

Setup

Install the http plugin to get started.

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

Usage

The HTTP plugin is available in both Rust as a reqwest re-export and JavaScript.

JavaScript

1. Configure the allowed URLs

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

   For more information, please see the documentation for Permissions Overview

2. Send a request

   The fetch method tries to be as close and compliant to the fetch Web API as possible.

   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"

Rust

In Rust you can utilize the reqwest crate re-exported by the plugin. For more details refer to reqwest docs.

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.

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

Permission Table