Scripts
Collection of JS scripts for WordPress development.
Installation
Install the module
npm install @wordpress/scripts --save-dev
Setup
This is a CLI and exposes a binary called wp-scripts
so you can call it directly. However this module is designed to be configured using the scripts
section in the package.json
file of your project.
Example:
{
"scripts": {
"lint:pkg-json": "wp-scripts lint-pkg-json .",
"test": "wp-scripts test-unit-js"
}
}
Available Scripts
wp-scripts lint-pkg-json
Helps enforce standards for your package.json file. It uses npm-package-json-lint with the set of default rules provided. You can override them with your own rules as described in npm-package-json-lint wiki.
Example:
{
"scripts": {
"lint:pkg-json": "wp-scripts lint-pkg-json ."
}
}
This is how you execute those scripts using the presented setup:
npm run lint:pkg-jsont
- lints package.json
file in the project's root folder.
wp-scripts test-unit-js
Alias: wp-scripts test-unit-jest
Launches the test runner. It uses Jest behind the scenes and you are able to utilize all of its CLI options. You can also run ./node_modules/.bin/wp-scripts test-unit-js --help
or npm run test:help
(as presented below) to view all of the available options.
Example:
{
"scripts": {
"test": "wp-scripts test-unit-js",
"test:help": "wp-scripts test-unit-js --help",
"test:watch": "wp-scripts test-unit-js --watch"
}
}
This is how you execute those scripts using the presented setup:
npm run test
or npm test
- runs all unit tests.npm run test:help
- prints all available options to configure unit tests runner.npm run test:watch
- runs all unit tests in the watch mode.
Inspiration
This is inspired by react-scripts and kcd-scripts.