axios-cookiejar-support

Add tough-cookie support to axios.

Github stars Tracking Chart

axios-cookiejar-support

Add tough-cookie support to axios.


NPM
LICENSE
CircleCI

dependencies
peerdependencies
devdependencies

Install

$ npm i axios axios-cookiejar-support

-- OR --

$ npm i axios @3846masa/axios-cookiejar-support # Same as above

Usage

const axios = require('axios').default;
const axiosCookieJarSupport = require('axios-cookiejar-support').default;
const tough = require('tough-cookie');

axiosCookieJarSupport(axios);

const cookieJar = new tough.CookieJar();

axios
  .get('https://google.com', {
    jar: cookieJar, // tough.CookieJar or boolean
    withCredentials: true, // If true, send cookie stored in jar
  })
  .then(() => {
    console.log(cookieJar);
  });

See examples.

Notice: Set default cookiejar

axios@>=0.19.0 cannot assign defaults.jar via axios.create() before wrapping instance.
When you want to set defaults.jar, please set directly after wrapping instance.

const axios = require('axios').default;
const axiosCookieJarSupport = require('axios-cookiejar-support').default;
const tough = require('tough-cookie');

const instance = axios.create({
  // WARNING: This value will be ignored.
  jar: new tough.CookieJar(),
});

// Set directly after wrapping instance.
axiosCookieJarSupport(instance);
instance.defaults.jar = new tough.CookieJar();

Extended Request Config

c.f.) https://github.com/mzabriskie/axios#request-config

{
  // `jar` is tough.CookieJar instance or boolean.
  // If true, axios create CookieJar automatically.
  jar: undefined, // default

  // **IMPORTANT**
  // If false, axios DONOT send cookies from cookiejar.
  withCredentials: false // default
}

Browser

Running on browser, this library becomes noop (config.jar might be ignored).

Contribution

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

LICENSE

MIT License

Author

3846masa icon
3846masa


Paypal.me (Onetime donate)

Main metrics

Overview
Name With Owner3846masa/axios-cookiejar-support
Primary LanguageTypeScript
Program languageJavaScript (Language Count: 3)
Platform
License:MIT License
所有者活动
Created At2016-09-01 10:53:55
Pushed At2025-06-08 02:06:59
Last Commit At
Release Count51
Last Release Namev6.0.2 (Posted on )
First Release Namev0.0.1 (Posted on )
用户参与
Stargazers Count323
Watchers Count3
Fork Count57
Commits Count1k
Has Issues Enabled
Issues Count71
Issue Open Count1
Pull Requests Count1214
Pull Requests Open Count0
Pull Requests Close Count99
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private