# jquery.cookie [![Build Status](https://travis-ci.org/carhartl/jquery-cookie.png?branch=master)](https://travis-ci.org/carhartl/jquery-cookie) [![Code Climate](https://codeclimate.com/github/carhartl/jquery-cookie.png)](https://codeclimate.com/github/carhartl/jquery-cookie)
A simple, lightweight jQuery plugin for reading, writing and deleting cookies.
**If you're viewing this at https://github.com/carhartl/jquery-cookie, you're reading the documentation for the master branch.
[View documentation for the latest release (1.4.1).](https://github.com/carhartl/jquery-cookie/tree/v1.4.1)**
## Build Status Matrix
[![Selenium Test Status](https://saucelabs.com/browser-matrix/jquery-cookie.svg)](https://saucelabs.com/u/jquery-cookie)
## Installation
Include script *after* the jQuery library (unless you are packaging scripts somehow else):
```html
<script src="/path/to/jquery.cookie.js"></script>
```
**Do not include the script directly from GitHub (http://raw.github.com/...).** The file is being served as text/plain and as such being blocked
in Internet Explorer on Windows 7 for instance (because of the wrong MIME type). Bottom line: GitHub is not a CDN.
The plugin can also be loaded as AMD or CommonJS module.
## Usage
Create session cookie:
```javascript
$.cookie('the_cookie', 'the_value');
```
Create expiring cookie, 7 days from then:
```javascript
$.cookie('the_cookie', 'the_value', { expires: 7 });
```
Create expiring cookie, valid across entire site:
```javascript
$.cookie('the_cookie', 'the_value', { expires: 7, path: '/' });
```
Read cookie:
```javascript
$.cookie('the_cookie'); // => "the_value"
$.cookie('not_existing'); // => undefined
```
Read all available cookies:
```javascript
$.cookie(); // => { "the_cookie": "the_value", "...remaining": "cookies" }
```
Delete cookie:
```javascript
// Returns true when cookie was found, false when no cookie was found...
$.removeCookie('the_cookie');
// Same path as when the cookie was written...
$.removeCookie('the_cookie', { path: '/' });
```
*Note: when deleting a cookie, you must pass the exact same path, domain and secure options that were used to set the cookie, unless you're relying on the default options that is.*
## Configuration
### raw
By default the cookie value is encoded/decoded when writing/reading, using `encodeURIComponent`/`decodeURIComponent`. Bypass this by setting raw to true:
```javascript
$.cookie.raw = true;
```
### json
Turn on automatic storage of JSON objects passed as the cookie value. Assumes `JSON.stringify` and `JSON.parse`:
```javascript
$.cookie.json = true;
```
## Cookie Options
Cookie attributes can be set globally by setting properties of the `$.cookie.defaults` object or individually for each call to `$.cookie()` by passing a plain object to the options argument. Per-call options override the default options.
### expires
expires: 365
Define lifetime of the cookie. Value can be a `Number` which will be interpreted as days from time of creation or a `Date` object. If omitted, the cookie becomes a session cookie.
### path
path: '/'
Define the path where the cookie is valid. *By default the path of the cookie is the path of the page where the cookie was created (standard browser behavior).* If you want to make it available for instance across the entire domain use `path: '/'`. Default: path of page where the cookie was created.
**Note regarding Internet Explorer:**
> Due to an obscure bug in the underlying WinINET InternetGetCookie implementation, IE’s document.cookie will not return a cookie if it was set with a path attribute containing a filename.
(From [Internet Explorer Cookie Internals (FAQ)](http://blogs.msdn.com/b/ieinternals/archive/2009/08/20/wininet-ie-cookie-internals-faq.aspx))
This means one cannot set a path using `path: window.location.pathname` in case such pathname contains a filename like so: `/check.html` (or at least, such cookie cannot be read correctly).
### domain
domain: 'example.com'
Define the domain where the cookie is valid. Default: domain of page where the cookie was created.
### secure
secure: true
If true, the cookie transmission requires a secure protocol (https). Default: `false`.
## Converters
Provide a conversion function as optional last argument for reading, in order to change the cookie's value
to a different representation on the fly.
Example for parsing a value into a number:
```javascript
$.cookie('foo', '42');
$.cookie('foo', Number); // => 42
```
Dealing with cookies that have been encoded using `escape` (3rd party cookies):
```javascript
$.cookie.raw = true;
$.cookie('foo', unescape);
```
You can pass an arbitrary conversion function.
## Contributing
Check out the [Contributing Guidelines](CONTRIBUTING.md)
## Authors
[Klaus Hartl](https://github.com/carhartl)
没有合适的资源?快使用搜索试试~ 我知道了~
基于django框架的一个小说分享网站Demo.zip
共208个文件
json:49个
jpg:44个
py:40个
需积分: 5 0 下载量 177 浏览量
2023-09-28
22:51:32
上传
评论
收藏 4.16MB ZIP 举报
温馨提示
基于django框架的一个小说分享网站Demo
资源推荐
资源详情
资源评论
收起资源包目录
基于django框架的一个小说分享网站Demo.zip (208个子文件)
nginx.conf 323B
.gitignore 40B
.gitignore 40B
book.html 11KB
registered.html 10KB
user.html 5KB
login.html 5KB
head.html 5KB
index.html 4KB
ranklist.html 3KB
search.html 3KB
updatebook.html 1KB
updatebook.html 1KB
index.html 622B
index.html 622B
jump.html 444B
malformed_cookie.html 424B
malformed_cookie.html 424B
bottom.html 190B
uwsgi.ini 176B
fm.jpg 119KB
fm.jpg 119KB
fm.jpg 107KB
fm.jpg 107KB
fm.jpg 84KB
fm.jpg 84KB
fm.jpg 82KB
fm.jpg 82KB
fm.jpg 68KB
fm.jpg 68KB
fm.jpg 62KB
fm.jpg 62KB
fm.jpg 61KB
fm.jpg 61KB
fm.jpg 60KB
fm.jpg 60KB
fm.jpg 59KB
fm.jpg 59KB
fm.jpg 57KB
fm.jpg 57KB
fm.jpg 57KB
fm.jpg 57KB
fm.jpg 53KB
fm.jpg 53KB
fm.jpg 52KB
fm.jpg 52KB
fm.jpg 48KB
fm.jpg 48KB
fm.jpg 48KB
fm.jpg 48KB
fm.jpg 43KB
fm.jpg 43KB
b_logo.jpg 35KB
b_logo.jpg 35KB
fm.jpg 32KB
fm.jpg 32KB
fm.jpg 28KB
fm.jpg 28KB
fm.jpg 26KB
fm.jpg 26KB
fm.jpg 18KB
fm.jpg 18KB
s_logo.jpg 17KB
s_logo.jpg 17KB
tests.js 9KB
tests.js 9KB
jquery.cookie.js 3KB
jquery.cookie.js 3KB
Gruntfile.js 2KB
Gruntfile.js 2KB
server.js 694B
server.js 694B
.jshintrc 237B
.jshintrc 237B
books.json 2.6MB
directory.json 276KB
directory.json 276KB
directory.json 177KB
directory.json 177KB
directory.json 154KB
directory.json 154KB
directory.json 138KB
directory.json 138KB
directory.json 119KB
directory.json 119KB
directory.json 102KB
directory.json 102KB
directory.json 95KB
directory.json 95KB
directory.json 93KB
directory.json 93KB
directory.json 91KB
directory.json 91KB
directory.json 48KB
directory.json 48KB
directory.json 28KB
directory.json 28KB
directory.json 26KB
directory.json 26KB
directory.json 26KB
共 208 条
- 1
- 2
- 3
资源评论
天天501
- 粉丝: 596
- 资源: 4666
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功