Spectral Linter for VS Code
The Spectral VS Code Extension brings the power of Spectral to your favorite editor.
Spectral is a flexible object linter with out of the box support for OpenAPI v2 and v3, Arazzo, JSON Schema, and AsyncAPI v2 and v3.
Features
- Lint-on-save
- Lint-on-type
- Custom ruleset support (
.spectral.json,.spectral.yaml,.spectral.ymlor.spectral.js) - Intellisense for custom ruleset editing
- Support for JSON and YAML input
Requirements
- Node.js ^12.21 or >=14.13
- Visual Studio Code version 1.48 or higher.
Installation
- Install from the Visual Studio Code Marketplace
- Install via the CLI:
code --install-extension stoplight.spectral
Extension Settings
This extension contributes the following settings:
spectral.enable: Controls whether or not Spectral is enabled.spectral.rulesetFile: Location of the ruleset file to use when validating. If omitted, the default is a.spectral.(json|yaml|yml)in the same folder as the document being validated. Paths are relative to the workspace. This can also be a remote HTTP url.spectral.run: Run the linter on save (onSave) or as you type (onType).spectral.validateFiles: An array of file globs (e.g.,**/*.yaml) which should be validated by Spectral. If language identifiers are also specified, the file must match both in order to be validated. You can also use negative file globs (e.g.,!**/package.json) here to exclude files.spectral.validateLanguages: An array of language IDs (e.g.,yaml,json) which should be validated by Spectral. If file globs are also specified, the file must match both in order to be validated.