Skip to content

Commit 133c2d4

Browse files
committed
docs(bom/cookie): edit set-cookie's domain property
1 parent 6dc6fb5 commit 133c2d4

File tree

1 file changed

+4
-2
lines changed

1 file changed

+4
-2
lines changed

docs/bom/cookie.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -342,7 +342,7 @@ document.cookie = "foo=bar; expires=Fri, 31 Dec 2020 23:59:59 GMT";
342342
各个属性的写入注意点如下。
343343

344344
- `path`属性必须为绝对路径,默认为当前路径。
345-
- `domain`属性值必须是当前发送 Cookie 的域名的一部分。比如,当前域名是`example.com`,就不能将其设为`foo.com`。该属性默认为当前的一级域名(不含二级域名)。
345+
- `domain`属性值必须是当前发送 Cookie 的域名的一部分。比如,当前域名是`example.com`,就不能将其设为`foo.com`。该属性默认为当前的一级域名(不含二级域名)。如果显式设置该属性,则该域名的任意子域名也可以读取 Cookie。
346346
- `max-age`属性的值为秒数。
347347
- `expires`属性的值为 UTC 格式,可以使用`Date.prototype.toUTCString()`进行日期格式转换。
348348

@@ -352,9 +352,11 @@ document.cookie = "foo=bar; expires=Fri, 31 Dec 2020 23:59:59 GMT";
352352
document.cookie = 'fontSize=14; '
353353
+ 'expires=' + someDate.toGMTString() + '; '
354354
+ 'path=/subdirectory; '
355-
+ 'domain=.example.com';
355+
+ 'domain=example.com';
356356
```
357357

358+
注意,上面的`domain`属性,以前的写法是`.example.com`,表示子域名也可以读取该 Cookie,新的写法可以省略前面的点。
359+
358360
Cookie 的属性一旦设置完成,就没有办法读取这些属性的值。
359361

360362
删除一个现存 Cookie 的唯一方法,是设置它的`expires`属性为一个过去的日期。

0 commit comments

Comments
 (0)