JSPM – chrome-cookie-decrypt@0.0.2

Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (chrome-cookie-decrypt) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

A Node.js package for retrieving and decrypting Google Chrome cookies on macOS. This utility allows you to programmatically access Chrome cookies for automation, testing, or data extraction purposes.

Description

chrome-cookie-decrypt provides a simple API to access encrypted Chrome cookies from the local Chrome installation on macOS. It handles all the complexity of:

Accessing the Chrome cookie database
Retrieving the encryption key from macOS Keychain
Decrypting the cookie values using Chrome's encryption algorithm

Installation

NPM

npm i chrome-cookie-decrypt

GitHub

npm i https://github.com/lacherogwu/chrome-cookie-decrypt

Requirements

macOS (this package is not compatible with Windows or Linux)
Node.js 16 or higher
Google Chrome installed on the system
SQLite3 command-line tool installed

Usage

import { getCookies } from 'chrome-cookie-decrypt';

// Get all Chrome cookies
const allCookies = await getCookies();
console.log(allCookies);

// Get cookies for a specific domain
const googleCookies = await getCookies('google.com');
console.log(googleCookies);

API

`getCookies(domain?: string): Promise<Cookie[]>`

Retrieves and decrypts Chrome cookies.

Parameters:
- domain (optional): Filter cookies by domain (e.g., 'google.com')
Returns:
- Promise resolving to an array of Cookie objects

type Cookie = {
    domain: string; // Cookie domain
    path: string; // Cookie path
    secure: boolean; // Whether the cookie requires a secure connection
    expires: number; // Expiration timestamp
    name: string; // Cookie name
    value: string; // Decrypted cookie value
    httpOnly: boolean; // Whether the cookie is HTTP only
    sameSite: 'None' | 'Lax' | 'Strict'; // SameSite policy
};

License

MIT

chrome-cookie-decrypt