HTML DOM Document cookie属性

定義と用法

cookie セミコロンで区切られた属性の設定または返却 key=value (ドキュメントcookie)リストに対して。

cookieの作成例:

document.cookie="username=Bill Gates; expires=Thu, 18 Dec 2013 12:00:00 UTC; path=/";

ヒント:Cookieには、カンマ、セミコロン、またはスペースを含めることができません。encodeURIComponent() メソッド それらが失われることを確実にします。

も参照してください:

JavaScript Cookiesチュートリアル

推奨:

時にはStorage APIがより良いツールです:

localStorage属性

sessionStorage属性

このドキュメントに関連するすべてのcookieを取得します:

let allCookies = document.cookie;

自分で試してみてください

文法

cookieを返します:

document.cookie

cookieを設定します:

document.cookie = newCookie

パラメータ

セミコロンで区切られた name=value リストに続き、任意のオプションが指定されます:

expires=date
GMT形式の日付(Date.toUTCStringメソッドを使用して)。
デフォルト値:ブラウザを閉じるとcookieが削除されます。
max-age=seconds
cookieを削除する前に最大の年齢。 0または過去の日付の場合、cookieを削除します。
path=path
cookieが属するディレクトリの絶対パス('/dir')。 デフォルト値:現在のディレクトリ。
domain=domainname
サイトのドメイン('example.com')。 デフォルト値:ドキュメントのドメイン。
secure
セキュアプロトコル(https)を使用してcookieをサーバーに送信します。

返り値

タイプ 説明
文字列 セミコロンで区切られた key=value リスト(ドキュメントCookie)に対して。

Cookieとローカルストレージ

Cookiesはクライアント-サーバー(ブラウザ-サーバー)アプリケーションに使用されます。

ローカルストレージ(Local Storage)はクライアント(ブラウザ)アプリケーションに使用されます。

Cookieはウェブサイトに関連しています。データがクライアント(ブラウザ)に供給される場合、HTTPヘッダーにcookieを送信することは帯域幅の無駄です。

一部のユーザーのブラウザでは通常Cookieが無効になっています。

Cookieのサイズ制限は4KBです。ローカルストレージの各ドメインの制限は5メガバイトです。

Cookie には有効期限があります。ローカルストレージにはありません。

ブラウザのサポート

document.cookie は DOM Level 2 (2001) 特性です。

すべてのブラウザでサポートされています:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
サポート 9-11 サポート サポート サポート サポート