Novelty Plastic Moustache
    Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org »

    cookie-parserpublic

    cookie-parser

    NPM Version NPM Downloads Node.js Version Build Status Test Coverage

    Parse Cookie header and populate req.cookies with an object keyed by the cookie names. Optionally you may enable signed cookie support by passing a secret string, which assigns req.secret so it may be used by other middleware.

    Installation

    $ npm install cookie-parser

    API

    var express      = require('express')
    var cookieParser = require('cookie-parser')
     
    var app = express()
    app.use(cookieParser())

    cookieParser(secret, options)

    • secret a string or array used for signing cookies. This is optional and if not specified, will not parse signed cookies. If a string is provided, this is used as the secret. If an array is provided, an attempt will be made to unsign the cookie with each secret in order.
    • options an object that is passed to cookie.parse as the second option. See cookie for more information.
      • decode a function to decode the value of the cookie

    cookieParser.JSONCookie(str)

    Parse a cookie value as a JSON cookie. This will return the parsed JSON value if it was a JSON cookie, otherwise it will return the passed value.

    cookieParser.JSONCookies(cookies)

    Given an object, this will iterate over the keys and call JSONCookie on each value. This will return the same object passed in.

    cookieParser.signedCookie(str, secret)

    Parse a cookie value as a signed cookie. This will return the parsed unsigned value if it was a signed cookie and the signature was valid, otherwise it will return the passed value.

    The secret argument can be an array or string. If a string is provided, this is used as the secret. If an array is provided, an attempt will be made to unsign the cookie with each secret in order.

    cookieParser.signedCookies(cookies, secret)

    Given an object, this will iterate over the keys and check if any value is a signed cookie. If it is a signed cookie and the signature is valid, the key will be deleted from the object and added to the new object that is returned.

    The secret argument can be an array or string. If a string is provided, this is used as the secret. If an array is provided, an attempt will be made to unsign the cookie with each secret in order.

    Example

    var express      = require('express')
    var cookieParser = require('cookie-parser')
     
    var app = express()
    app.use(cookieParser())
     
    app.get('/', function(req, res) {
      console.log('Cookies: ', req.cookies)
    })
     
    app.listen(8080)
     
    // curl command that sends an HTTP request with two cookies 
    // curl http://127.0.0.1:8080 --cookie "Cho=Kim;Greet=Hello" 

    MIT Licensed

    install

    npm i cookie-parser

    Downloadslast 7 days

    944,830

    version

    1.4.3

    license

    MIT

    repository

    github.com

    last publish

    collaborators

    • avatar
    • avatar