NPM-TEST(1) NPM-TEST(1)

# [NAME](#NAME)

**npm-test** - Test a package

## [Synopsis](#Synopsis)

```
npm test [-- <args>]
aliases: tst, t
```

## [Description](#Description)

This runs a predefined command specified in the **"test"** property of a package's **"scripts"** object.

## [Example](#Example)

```
{


  "scripts": {


    "test": "node test.js"


  }
}
```

```
npm test
> npm@x.x.x test
> node test.js
(test.js output would be here)
```

## [Configuration](#Configuration)

## **ignore-scripts**

- Default: false
- Type: Boolean

If true, npm does not run scripts specified in package.json files.

Note that commands explicitly intended to run a particular script, such as **npm start**, **npm stop**, **npm restart**, **npm test**, and **npm run** will still run their intended script if **ignore-scripts** is set, but they will *not* run any pre- or post-scripts.

Setting **ignore-scripts** also disables **.npm-extension** execution, as if **ignore-extension** were set.

## **script-shell**

- Default: '/bin/sh' on POSIX systems, 'cmd.exe' on Windows
- Type: null or String

The shell to use for scripts run with the **npm exec**, **npm run** and **npm** **init &lt;package-spec&gt;** commands.

## [See Also](#See_Also)

- npm help run
- npm help scripts
- npm help start
- npm help restart
- npm help stop

September 2026 NPM@12.1.0

---

Document: npm-test(1) from npm-12 12.1.0-r1 (Chainguard OS)
Source: https://github.com/npm/cli