https://github.com/idootop/tauri-plugin-cors-fetch
Enabling Cross-Origin Resource Sharing (CORS) for Fetch Requests within Tauri applications.
https://github.com/idootop/tauri-plugin-cors-fetch
cors fetch tauri unofficial-tauri-plugin
Last synced: 5 months ago
JSON representation
Enabling Cross-Origin Resource Sharing (CORS) for Fetch Requests within Tauri applications.
- Host: GitHub
- URL: https://github.com/idootop/tauri-plugin-cors-fetch
- Owner: idootop
- License: mit
- Created: 2024-03-23T13:09:49.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-06-28T12:42:22.000Z (12 months ago)
- Last Synced: 2025-12-20T16:54:50.267Z (6 months ago)
- Topics: cors, fetch, tauri, unofficial-tauri-plugin
- Language: Rust
- Homepage: https://crates.io/crates/tauri-plugin-cors-fetch
- Size: 752 KB
- Stars: 17
- Watchers: 1
- Forks: 6
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://crates.io/crates/tauri-plugin-cors-fetch)
[](https://crates.io/crates/tauri-plugin-cors-fetch)
[](./LICENSE)
[](https://docs.rs/crate/tauri-plugin-cors-fetch)
An **unofficial** Tauri plugin that enables **seamless cross-origin (CORS) requests** by transparently proxying the native `fetch` API through Tauri's HTTP client.
## Features
- **Zero Code Change**: Use standard `fetch()` as you normally would.
- **Transparent Proxying**: Automatically hooks into the browser's fetch.
- **Configurable**: Granular control over which domains bypass CORS.
- **Multi-platform**: Supports _Windows, macOS, Linux, iOS, and Android_.
## Quick Start
**1. Install Dependencies**
Add the plugin to your `Cargo.toml`:
```shell
# src-tauri
cargo add tauri-plugin-cors-fetch
```
**2. Initialize Plugin**
Register the plugin in your Tauri setup:
```rust
// src-tauri/src/lib.rs
pub fn run() {
tauri::Builder::default()
.plugin(tauri_plugin_cors_fetch::init()) // 👈 here
.run(tauri::generate_context!())
.expect("failed to run app");
}
```
**3. Configure Permissions & Settings**
Add the required permission to your capability file:
```json
// src-tauri/capabilities/default.json
{
"permissions": ["cors-fetch:default"]
}
```
Ensure `withGlobalTauri` is enabled in `tauri.conf.json`:
```json
// src-tauri/tauri.conf.json
{
"app": {
"withGlobalTauri": true
}
}
```
## Usage
Once initialized, the plugin automatically hooks into the global `fetch`. No changes to your frontend code are required:
```javascript
// This request now bypasses CORS automatically
const response = await fetch("https://api.openai.com");
const data = await response.json();
```
### Configuration
You can fine-tune the behavior via `window.CORSFetch.config()`:
```javascript
window.CORSFetch.config({
include: [/^https?:\/\//i], // Patterns to proxy (default: all)
exclude: ["https://api.openai.com/v1/chat/completions"],
// Default request options for Tauri HTTP Client
request: {
connectTimeout: 30 * 1000, // ms
maxRedirections: 5,
proxy: { all: "http://127.0.0.1:7890" },
},
});
```
### Direct Access APIs
- `window.fetchCORS(url, init)`: Explicitly use the CORS-bypassing fetch.
- `window.fetchNative(url, init)`: Use the original browser fetch (subject to CORS).
## Limitations
- **Fetch Only**: Does not support `XMLHttpRequest` (XHR).
- **No Streaming**: Server-Sent Events (SSE) and response streaming are currently not supported.
## License
MIT License © 2024-PRESENT [Del Wang](https://del.wang)