jest-runner-vscode

jest-runner-vscode

Run VS Code tests using Jest Testing Framework

Table of contents

• Installation
• Setup
• Environment variables
• Contributing
• License

Installation

yarn

yarn add jest jest-runner-vscode --dev

npm

npm i jest jest-runner-vscode --save-dev

Setup

Example launch.json

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Jest: All tests",
      "type": "extensionHost",
      "request": "launch",
      "runtimeExecutable": "${execPath}",
      "stopOnEntry": false,
      "sourceMaps": true,
      "smartStep": true,
      "args": [
        "--disable-extensions",
        "--extensionDevelopmentPath=${workspaceFolder}",
        "--extensionTestsPath=${workspaceFolder}/node_modules/jest-runner-vscode"
      ],
      "skipFiles": ["<node_internals>/**/*.js"],
      "outFiles": ["${workspaceFolder}/dist/**/*.js"],
      "preLaunchTask": "npm: compile",
      "internalConsoleOptions": "openOnSessionStart",
      "env": {
        "JEST_RUNNER_VSCODE_TEST_REGEX": ""
      }
    },
    {
      "name": "Jest: Current file",
      "type": "extensionHost",
      "request": "launch",
      "runtimeExecutable": "${execPath}",
      "stopOnEntry": false,
      "sourceMaps": true,
      "smartStep": true,
      "args": [
        "--disable-extensions",
        "--extensionDevelopmentPath=${workspaceFolder}",
        "--extensionTestsPath=${workspaceFolder}/node_modules/jest-runner-vscode"
      ],
      "skipFiles": ["<node_internals>/**/*.js"],
      "outFiles": ["${workspaceFolder}/dist/**/*.js"],
      "preLaunchTask": "npm: compile",
      "internalConsoleOptions": "openOnSessionStart",
      "env": {
        "JEST_RUNNER_VSCODE_TEST_REGEX": "${file}"
      }
    }
  ]
}

Environment variables

JEST_RUNNER_VSCODE_TEST_REGEX
The pattern Jest uses to detect test files.

JEST_RUNNER_VSCODE_SETUP
The path to a module that runs some code to configure or set up the testing framework before each test. You can use this to mock VS Code APIs, such as forcing the getConfiguration API to use an in-memory cache vs. interacting with the file system (see shifty example).

Example launch.json:

"env": {
  "JEST_RUNNER_VSCODE_SETUP": "${workspaceFolder}/dist/test-utils/jest-runner-vscode-setup.js",
}

Contributing

• Fork this repository to your own GitHub account and then clone it to your local device
• Install the dependecies using yarn
• Link the package to the global module directory: yarn link
• Run yarn test --watch and start making your changes
• You can use yarn link jest-runner-vscode to test your changes in a local project
• Ensure any changes are documented in CHANGELOG.md

License

MIT © Brent Mealhouse