tencent cloud

Tencent Cloud EdgeOne

Cookies

ダウンロード
フォーカスモード
フォントサイズ
最終更新日: 2026-10-15 18:20:38
AI翻訳
Cookiesは一連のcookie操作インターフェースを提供します。
注意:
Cookiesオブジェクトはname + domain + pathを一意のキーとして、Cookieオブジェクトセットを管理します。

コンストラクタ

const cookies = new Cookies(cookieStr?: string, isSetCookie?: boolean);

パラメータ

パラメータ名
タイプ
必須
説明
cookieStr
string
いいえ
Cookie文字列またはSet-Cookie文字列。
isSetCookie
boolean
いいえ
パラメータcookieStrがSet-Cookie文字列であるかどうかを示します。デフォルトはfalseです。

方法

get

cookies.get(name?: string): null | Cookie | Array<Cookie>;
指定された名前のCookieオブジェクトを取得します。複数のnameが一致する場合、Cookieの配列を返します。

パラメータ

パラメータ名
タイプ
必須
説明
name
string
いいえ
Cookie名、値の説明は以下の通りです。
デフォルト名
すべてのCookieオブジェクトを取得することを示します。
nameを指定します。
指定されたnameのCookieオブジェクトを取得することを示します。複数一致する場合、Cookie配列を返します。
Cookieオブジェクトの属性は以下の通りです。詳細はMDN公式ドキュメントSet-Cookieを参照してください。
属性名
タイプ
読み取り専用
説明
name
string
はい
Cookie名。
value
string
はい
Cookie値。
domain
string
はい
Cookieの適用ドメイン。
path
string
はい
Cookieの適用パス。
expires
string
はい
Cookieの最長有効時間です。値はHTTP Dateヘッダー標準に準拠します。
max_age
string
はい
Cookieはmax_age秒経過後に無効になります。単位は秒(s)です。
samesite
string
はい
Cookieのクロスサイトリクエストフォージェリ(CSRF)攻撃に対する保護を制御します。
httponly
boolean
はい
JavaScriptによるCookieへのアクセスを禁止し、HTTPリクエストのみがCookieを携帯します。
secure
boolean
はい
CookieはHTTPSリクエストプロトコルでのみ携帯されます。

set

cookies.set(name: string, value: string, options?: Cookie): boolean;
Cookieを上書き追加します。trueを返す場合は追加成功を示し、falseを返す場合は追加失敗を示します(cookies数の制限を超えました。詳細はcookiesサイズ制限を参照してください)。
注意:
name + domain + pathを一意のキーとして、Cookieを上書き追加します。

パラメータ

パラメータ名
タイプ
必須
説明
name
string
はい
Cookie名。
value
string
はい
Cookie値。
Cookie
string
いいえ
Cookie属性設定項目。

append

cookies.append(name: string, value: string, options?: Cookie): boolean;
Cookieを追加します。同じnameで複数のvalueがある場合に使用します。trueを返す場合は追加成功を示し、falseを返す場合は追加失敗を示します(valueが重複しているか、cookies数の制限を超えています。詳細はcookiesサイズ制限を参照してください)。
注意:
name + domain + pathを一意のキーとしてCookieを追加します。

remove

cookies.remove(name: string, options?: Cookie): boolean;
Cookieを削除します。
注意:
name + domain + pathを一意のキーとしてCookieを削除します。

パラメータ

パラメータ名
タイプ
必須
説明
name
string
はい
Cookie名。
options
はい
Cookie属性設定項目です。属性domainとpathは*をサポートし、すべてに一致することを示します。

利用制限

特殊文字の自動エスケープ

name値に文字 \\" ( ) , / : ; ? < = > ? @ [ ] \\\\ { }、0x00~0x1F、0x7F~0xFFが含まれる場合、自動的にエスケープされます。
value値に文字 , 、 ; \\" \\\\、0x00~0x1F、0x7F~0xFFが含まれる場合、自動的にエスケープされます。

Cookieサイズ制限

Cookie属性nameのサイズは64Bを超えません。
Cookie属性value、domain、path、expires、max_age、samesiteの合計サイズは1KBを超えません。
cookiesエスケープ後の全フィールドの合計長は4KBを超えません。
cookiesに含まれるCookieオブジェクトの総数は64個を超えません。

サンプルコード

function handleEvent(event) {
const response = new Response('hello world');

// cookiesオブジェクトを生成します。
const cookies = new Cookies('ssid=helloworld; expires=Sun, 10-Dec-2023 03:10:01 GMT; path=/; domain=.tencentcloud.com; samesite=.tencentcloud.com', true);

// レスポンスヘッダーSet-Cookieを設定します。
response.setCookies(cookies);

return response;
}

addEventListener('fetch', (event) => {
event.respondWith(handleEvent(event));
});

関連参考

ヘルプとサポート

この記事はお役に立ちましたか?

フィードバック