@types/cookie-parser

Installation

npm install --save @types/cookie-parser

Summary

This package contains type definitions for cookie-parser (https://github.com/expressjs/cookie-parser).

Details

Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/cookie-parser.

index.d.ts

import express = require("express");

declare module "express" {
    // Inject additional properties on express.Request
    interface Request {
        /**
         * This request's secret.
         * Optionally set by cookie-parser if secret(s) are provided.  Can be used by other middleware.
         * [Declaration merging](https://www.typescriptlang.org/docs/handbook/declaration-merging.html) can be used to add your own properties.
         */
        secret?: string | undefined;
        /** Parsed cookies that have not been signed */
        cookies: Record<string, any>;
        /** Parsed cookies that have been signed */
        signedCookies: Record<string, any>;
    }
}

declare function cookieParser(
    secret?: string | string[],
    options?: cookieParser.CookieParseOptions,
): express.RequestHandler;

declare namespace cookieParser {
    interface CookieParseOptions {
        decode?(val: string): string;
    }

    function JSONCookie(jsonCookie: string): object | undefined;

    function JSONCookies<T extends { [key: string]: string }>(jsonCookies: T): { [P in keyof T]: object | undefined };

    function signedCookie(cookie: string, secret: string | string[]): string | false;

    function signedCookies<T extends { [key: string]: string }>(
        cookies: T,
        secret: string | string[],
    ): { [P in keyof T]?: string | false };
}

export = cookieParser;

Additional Details

• Last updated: Fri, 24 Oct 2025 04:02:41 GMT
• Dependencies: none
• Peer dependencies: @types/express

Credits

These definitions were written by Santi Albo, BendingBender, and Sebastian Beltran.

Similar packages

Other packages similar to @types/cookie-parser

cookie-session

cookie-session is a middleware for Express that enables session support through cookies. Unlike @types/cookie-parser, which is focused on parsing cookies and populating req.cookies, cookie-session is used for managing session state in web applications, storing session data on the client-side within cookies. It provides a different layer of functionality compared to simply parsing cookies.

express-session

express-session is another session management middleware for Express, but unlike cookie-session, it supports storing session data on the server-side, with the session ID being stored in a cookie on the client-side. This approach offers more control and security over session data compared to storing all session data within cookies. While @types/cookie-parser is focused on parsing cookies, express-session deals with sessions more comprehensively.