---
url: /docs/guide/usage/linter/rules/unicorn/no-document-cookie.md
---

### 作用

禁止直接使用
[`document.cookie`](https://developer.mozilla.org/en-US/docs/Web/API/Document/cookie)。

### 为什么这不好？

不建议直接使用
[`document.cookie`](https://developer.mozilla.org/en-US/docs/Web/API/Document/cookie)，
因为很容易把字符串写错。相反，你应该使用
[Cookie Store
API](https://developer.mozilla.org/en-US/docs/Web/API/Cookie_Store_API)
或 [cookie 库](https://npmx.dev/search?q=cookie)。

### 示例

以下是此规则的**错误**代码示例：

```javascript
document.cookie =
  "foo=bar" +
  "; Path=/" +
  "; Domain=example.com" +
  "; expires=Fri, 31 Dec 9999 23:59:59 GMT" +
  "; Secure";
```

以下是此规则的**正确**代码示例：

```javascript
async function storeCookies() {
  await cookieStore.set({
    name: "foo",
    value: "bar",
    expires: Date.now() + 24 * 60 * 60 * 1000,
    domain: "example.com",
  });
}
```

## 如何使用

## 版本

此规则于 v0.0.18 中加入。

## 参考资料