Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

restify-cookies

Package Overview
Dependencies
Maintainers
1
Versions
9
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

restify-cookies

Adds cookie parsing/setting to restify

  • 0.2.6
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
10K
increased by13.34%
Maintainers
1
Weekly downloads
 
Created
Source

Restify-Cookies

Build Status

Adds cookie reading/setting to restify.

Adds the request.cookie object, which is a hash containing all the key-value cookie pairs sent with this request. For setting cookies this adds the response.setCookie method, which takes a key and value and adds it to the cookie header.

response.setCookie('key', 'value'),
response.setCookie('key', 'value', cookieOptions);  // options explained below

There is also response.clearCookie, which will set the value of a cookie to an empty string. It takes a key and optionally additional cookie options.

response.clearCookie('key');
response.clearCookie('key', cookieOptions);  // options explained below

Installation:

npm install restify-cookies

Example Usage:

var CookieParser = require('restify-cookies');
var Restify = require('restify');

var server = Restify.createServer();

server.use(CookieParser.parse);

server.get('/', function(req, res, next){
  var cookies = req.cookies; // Gets read-only cookies from the request

  res.setCookie('my-new-cookie', 'Hi There'); // Adds a new cookie to the response

  if (req.cookies['my-old-cookie']){
    res.clearCookie('my-old-cookie');  // Remove this old cookie
  }
  
  res.send(JSON.stringify(cookies));

});

server.listen(8080);

Cookies can have options specified detailing the lifetime of the cookie, the domain, the paths the cookie is set for, HTTPS only and disallowing JavaScript access to the cookie. To set these options use setCookie with the optional third parameter or clearCookie with the optional second parameter.

The cookie options object is a hash containing these fields:

  • path - A string path the cookie is valid for. Default: no path.
  • expires - Date object for when the cookie should expire. Default: No expiry.
  • maxAge - Number of seconds until the cookie should expire. Default: No max age.
  • domain - The domain the cookie will be sent over. Default: origin only.
  • secure - Set to true if the cookie should only be sent for HTTPS requests. Default: false.
  • httpOnly - Set to true to disable client-side manipulation of the cookie. Default: false.

Example:


  res.setCookie('myCookie', 'Hi There', {
    path: '/home/',
    domain: 'www.example.com',
    maxAge: 60,
    secure: true,
    httpOnly: true
  });

License

MIT License

Keywords

FAQs

Package last updated on 13 Nov 2019

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc