# chrome-cookies-secure-promise

> Extract encrypted Google Chrome cookies for a url on a Mac or Linux

Latest version **0.0.7** (published 2017-12-08) · MIT license · 0 weekly downloads

> **Deprecated.** This package is deprecated.

## Install

```sh
npm install chrome-cookies-secure-promise
pnpm add chrome-cookies-secure-promise
yarn add chrome-cookies-secure-promise
bun add chrome-cookies-secure-promise
```

## Health

**Score 10/100 (F)** — status: deprecated.

Negative: deprecated.

## Facts

| | |
|---|---|
| Version | 0.0.7 |
| Published | 2017-12-08 |
| First published | 2017-05-08 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 5 |
| Known vulnerabilities | 0 (+2 in 2 direct dependencies) |
| Install scripts | no |
| Author | John Ferlito |
| Maintainers | johnf |
| Keywords | google, chrome, cookies, encrypted, curl, decrypt, encrypt, extract |

## Links

- npm: https://www.npmjs.com/package/chrome-cookies-secure-promise
- Repository: https://github.com/johnf/chrome-cookies-secure-promise
- npm.io page: https://npm.io/package/chrome-cookies-secure-promise

## Dependencies (5)

- [tldjs](https://npm.io/package/tldjs.md) ^1.5.1
- [keytar](https://npm.io/package/keytar.md) ^4.0.2
- [sqlite](https://npm.io/package/sqlite.md) ^2.7.0
- [request](https://npm.io/package/request.md) ^2.49.0
- [tough-cookie](https://npm.io/package/tough-cookie.md) ^2.3.2

## Alternatives

- [base64url](https://npm.io/package/base64url.md) — 6.1M weekly downloads
- [get-installed-path](https://npm.io/package/get-installed-path.md) — 502.9K weekly downloads
- [@uppy/url](https://npm.io/package/@uppy/url.md) — 185.8K weekly downloads
- [@d3fc/d3fc-shape](https://npm.io/package/@d3fc/d3fc-shape.md) — 16.2K weekly downloads
- [localizer](https://npm.io/package/localizer.md) — 226 weekly downloads

## Recent versions

- 0.0.7 (latest) — 2017-12-08
- 0.0.6 — 2017-05-08
- 0.0.5 — 2017-05-08
- 0.0.4 — 2017-05-08
- 0.0.3 — 2017-05-08
- 0.0.2 — 2017-05-08

## README

# chrome-cookies-secure-promise

# I am no longer working on this project, if you would like to take it over please let me know.

Extract encrypted Google Chrome cookies for a url on Mac OS X or Linux

This is a fork of https://github.com/bertrandom/chrome-cookies-secure which is
promise based.

## Installation

```
yarn add chrome-cookies-secure-promise
```

## API

getCookies(url[,format])
---------------------------------

`url` should be a fully qualified url, e.g. `http://www.example.com/path/`

`format` is optional and can be one of the following values:

format | description
------------ | -------------
curl | [Netscape HTTP Cookie File](http://curl.haxx.se/docs/http-cookies.html) contents usable by curl and wget
jar | cookie jar compatible with [request](https://www.npmjs.org/package/request)
set-cookie | Array of Set-Cookie header values
header | `cookie` header string, similar to what a browser would send
object | (default) Object where key is the cookie name and value is the cookie value. These are written in order so it's possible that duplicate cookie names will be overriden by later values

If `format` is not specified, `object` will be used as the format by default.

Cookie order tries to follow [RFC 6265 - Section 5.4, step 2](http://tools.ietf.org/html/rfc6265#section-5.4) as best as possible.

## Examples

basic usage
-----------

```
import * as chrome from 'chrome-cookies-secure-promise';

chrome.getCookies('http://www.example.com/path/')
  .then(cookies => console.log(cookies));
```

jar used with request
---------------------

```
import request from 'request';
import * as chrome from 'chrome-cookies-secure-promise';

chrome.getCookies('http://www.example.com/', 'jar')
  .then(jar => request({url: 'http://www.example.com/', jar: jar}))
  .then(body => console.log(body));
```

## Limitations

On OS X, this module requires Keychain Access to read the Google Chrome encryption key. The first time you use it, it will popup this dialog:

![image](https://raw.githubusercontent.com/johnf/chrome-cookies-secure-promise/gh-pages/access.png)
=======

The SQLite database that Google Chrome stores its cookies is only persisted to every 30 seconds or so, so this can explain while you'll see a delay between which cookies your browser has access to and this module.

## Development

After checking out the repo, run `yarn test` to run the tests.

To release a new version:

* yarn test
* yarn version
* yarn publish

This will run the tests, update the version, create a git tag for the version,
push git commits and tags. Publish the module file to
[npmjs.com](https://npmjs.com).

## Contributing

Bug reports and pull requests are welcome on GitHub at
https://github.com/johnf/chromecast-discover-node. This project is intended to
be a safe, welcoming space for collaboration, and contributors are expected to
adhere to the [Contributor Covenant](contributor-covenant.org) code of conduct.

## License

This software is free to use under the MIT license. See the [LICENSE file][] for license text and copyright information.

[LICENSE file]: https://github.com/johnf/chrome-cookies-secure-promise/blob/master/LICENSE.md

---
_Source: https://npm.io/package/chrome-cookies-secure-promise · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._