lint-staged

  • Version 17.4.1
  • Published
  • 168 kB
  • 3 dependencies
  • MIT license

Install

npm i lint-staged
yarn add lint-staged
pnpm add lint-staged

Overview

Lint files staged by git

Index

Functions

Type Aliases

Functions

function lintStaged

lintStaged: (options: Options, logger?: Logger) => Promise<boolean>;
  • Returns

    {boolean} true when all tasks were successful, false when some tasks failed with errors

    Throws

    {Error} when failed to some other errors

Type Aliases

type Logger

type Logger = {
log: LogFunction;
warn: LogFunction;
error: LogFunction;
debug: LogFunction;
};

    type Options

    type Options = {
    /**
    * Include all files tracked in Git instead of only staged
    * @warn implies `stash: false` and `allowEmpty: true`
    * @default false
    */
    all?: boolean;
    /**
    * Allow empty commits when tasks revert all staged changes
    * @default false
    */
    allowEmpty?: boolean;
    /**
    * Enable or disable ANSI color codes in output. By default value is auto-detected
    * and controlled by `FORCE_COLOR` or `NO_COLOR` env variables.
    */
    color?: boolean;
    /**
    * The number of tasks to run concurrently, or `false` to run tasks serially
    * @default true
    */
    concurrent?: boolean | number;
    /**
    * Manual task configuration; disables automatic config file discovery when used
    */
    config?: Configuration;
    /**
    * Path to single configuration file; disables automatic config file discovery when used
    */
    configPath?: string;
    /**
    * Run all tasks to completion even if one fails
    * @default false
    */
    continueOnError?: boolean;
    /**
    * Working directory to run all tasks in, defaults to current working directory
    */
    cwd?: string;
    /**
    * Whether or not to enable debug output
    * @default false
    */
    debug?: boolean;
    /**
    * Override the default `--staged` flag of `git diff` to get list of files.
    * @warn changing this also implies `stash: false`.
    * @example HEAD...origin/main
    */
    diff?: string;
    /**
    * Override the default `--diff-filter=ACMR` flag of `git diff` to get list of files
    * @default "ACMR"
    */
    diffFilter?: string;
    /**
    * Fail with exit code 1 when tasks modify tracked files
    * @default false
    */
    failOnChanges?: boolean;
    /**
    * Maximum argument string length, by default automatically detected
    */
    maxArgLength?: number;
    /**
    * Whether to hide unstaged changes from partially staged files before running tasks
    * @default true
    */
    hidePartiallyStaged?: boolean;
    /**
    * Whether to hide all unstaged changes before running tasks
    * @default false
    */
    hideUnstaged?: boolean;
    /**
    * Whether to hide all unstaged changes and untracked files before running tasks
    * @default false
    */
    hideAll?: boolean;
    /**
    * Disable lint-staged’s own console output
    * @default false
    */
    quiet?: boolean;
    /**
    * Pass filepaths relative to `CWD` to tasks, instead of absolute
    * @default false
    */
    relative?: boolean;
    /**
    * Revert to original state in case of errors
    * @default true
    */
    revert?: boolean;
    /**
    * Enable the backup stash, and revert in case of errors.
    * @warn Disabling this also implies `hidePartiallyStaged: false`.
    * @default true
    */
    stash?: boolean;
    /**
    * Show task output even when tasks succeed; by default only failed output is shown
    * @default false
    */
    verbose?: boolean;
    };
    • lint-staged Node.js API options

    Package Files (1)

    Dependencies (3)

    Dev Dependencies (14)

    Peer Dependencies (0)

    No peer dependencies.

    Badge

    To add a badge like this onejsDocs.io badgeto your package's README, use the codes available below.

    You may also use Shields.io to create a custom badge linking to https://www.jsdocs.io/package/lint-staged.

    • Markdown
      [![jsDocs.io](https://img.shields.io/badge/jsDocs.io-reference-blue)](https://www.jsdocs.io/package/lint-staged)
    • HTML
      <a href="https://www.jsdocs.io/package/lint-staged"><img src="https://img.shields.io/badge/jsDocs.io-reference-blue" alt="jsDocs.io"></a>