搜尋套件、儲存庫與 APP 分類

套件詳情v0.1.5

shelf_cors_headers

Shelf 的 CORS 請求頭中間件。

AndroidiOSWebmacOSWindowsLinux
近 30 天下載
4.2萬
喜歡數
41
Pub 分數
140

安裝套件

flutter pub add shelf_cors_headers

套件介紹

根據套件公開資料產生的選型評估,僅供參考。

Shelf CORS Headers 是一個用於 Shelf 框架的中間件套件,可簡化在 HTTP 回應中加入跨來源資源共用(CORS)標頭的過程。它透過設定允許的來源、方法、標頭與憑證,讓使用 Shelf 建構的伺服器端應用程式能安全處理跨來源請求。此套件可無縫整合至現有的 Shelf 伺服器中,為跨平台 Web 服務提供輕量且可設定的 CORS 政策管理方案。

適用情境

  • 在基於 Shelf 的 API 中啟用跨來源請求
  • 使用受控存取策略保護Web服務
  • 支援託管於不同網域的前端應用
  • 將 CORS 集成到 Flutter Web 後端
  • 自動處理預檢請求

主要特色

  • 可設定的允許來源
  • 支援自定標頭和方法
  • 自動處理 OPTIONS 預檢請求
  • 與 Shelf 路由器輕鬆整合
  • 靈活的憑證和最大年齡設定

適合對象

  • 使用 Shelf 進行後端邏輯的開發人員
  • Flutter 開發人員建構 Web API
  • 實施安全 RESTful 服務的團隊
  • 需要細粒度 CORS 控制的應用程式
  • 面向多個平台的伺服器端 Dart 項目

使用建議

  • 需要對CORS標準有基本了解
  • 不適用於獨立的客戶端使用
  • 配置在生產環境中必須仔細管理
  • 不包含超出 CORS 的請求驗證
  • 僅限基於貨架的伺服器環境

原始 README

以下為關聯原始碼儲存庫的 README 原文快照,最新內容請造訪原始碼儲存庫。

CORS headers middleware for Shelf

A Shelf middleware to add CORS headers to shelf responses.

Features

  • Handles preflight requests.
  • Allows override of default headers.
  • Allows user to provide their own origin checker function.

Usage

A simple usage example:

import 'package:shelf/shelf.dart';
import 'package:shelf/shelf_io.dart';
import 'package:shelf_cors_headers/shelf_cors_headers.dart';

void main() async {
  var handler = const Pipeline()
      // Just add corsHeaders() middleware.
      .addMiddleware(corsHeaders())
      .addHandler(_requestHandler);

  await serve(handler, 'localhost', 8080);
}

Response _requestHandler(Request request) {
  return Response.ok('Request for "${request.url}"');
}
Override Headers
import 'package:shelf/shelf.dart';
import 'package:shelf/shelf_io.dart';
import 'package:shelf_cors_headers/shelf_cors_headers.dart';

void main() async {
  // optionally override default headers
  final overrideHeaders = {
    ACCESS_CONTROL_ALLOW_ORIGIN: 'example.com',
    'Content-Type': 'application/json;charset=utf-8'
  };

  var handler = const Pipeline()
      // Just add corsHeaders() middleware and pass your header overrides.
      .addMiddleware(corsHeaders(headers: overrideHeaders))
      .addHandler(_requestHandler);

  await serve(handler, 'localhost', 8080);
}

Response _requestHandler(Request request) {
  return Response.ok('Request for "${request.url}"');
}
Custom origin checker

Your origin checker function should consume a string as a parameter(the value of ORIGIN header) and return a boolean value indicating if this middleware should process the request from that origin.

import 'package:shelf/shelf.dart';
import 'package:shelf/shelf_io.dart';
import 'package:shelf_cors_headers/shelf_cors_headers.dart';

// define our origin checker
bool dontCheckCNNRequests(String origin) {
  if (origin.contains('cnn.com')) return false;
  return true;
}

void main() async {
  // optionally override default headers
  final overrideHeaders = {
    'Content-Type': 'application/json;charset=utf-8'
  };

  var handler = const Pipeline()
      // Just add corsHeaders() middleware and pass your origin checker
      .addMiddleware(corsHeaders(headers: overrideHeaders, originChecker: dontCheckCNNRequests))
      .addHandler(_requestHandler);

  await serve(handler, 'localhost', 8080);
}

Response _requestHandler(Request request) {
  return Response.ok('Request for "${request.url}"');
}

You can also use the inbuilt originOneOf which takes a list of origins to check:

import 'package:shelf/shelf.dart';
import 'package:shelf/shelf_io.dart';
import 'package:shelf_cors_headers/shelf_cors_headers.dart';

// define our origin checker
final listChecker = originOneOf(['https://cnn.com', 'https://dart.dev'])

void main() async {
  // optionally override default headers
  final overrideHeaders = {
    'Content-Type': 'application/json;charset=utf-8'
  };

  var handler = const Pipeline()
      // Just add corsHeaders() middleware and pass your origin checker
      .addMiddleware(corsHeaders(headers: overrideHeaders, originChecker: listChecker))
      .addHandler(_requestHandler);

  await serve(handler, 'localhost', 8080);
}

Response _requestHandler(Request request) {
  return Response.ok('Request for "${request.url}"');
}

所屬分類

依賴

依賴清單 1 項

原始碼儲存庫

使用此套件的專案