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 的大小限制為 4 KB。本地存儲的每個域限制為 5 兆字節。

Cookie 有過期日期。本地存儲沒有。

瀏覽器支持

document.cookie 是 DOM Level 2 (2001) 特性。

所有瀏覽器都支持它：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 9-11 支持 支持 支持 支持