VS Code extension wrapper around canipls.
canipls
(Pronounced "can I please", á la gopls)
A language server that shows caniuse.com support percentages for web features, right in your editor.
Implements the following features of Microsoft's Language Server Protocol:
- diagnostics - shows warnings on features whose global support percentage falls below the user-defined desired support threshold (or the default, if none is specified.)
- hover - hover over any native HTML element, global attribute, CSS at-rule, property, psuedo-selector, JavaScript API or buultin, to see its global support percentage.
Supported file types:
- HTML
- CSS
- JavaScript/Typescript
- JSX/TSX
- Vue
- Svelte
- Astro
Usage
Ignoring lines
It is possible to opt out of canipls warnings for specific lines of code. This is done via various magic comments:
| comment text |
function |
canipls-ignore |
Ignore the line this comment is found on |
canipls-ignore-nextline |
Ignore the line following the one this comment is found on |
canipls-ignore-file |
Ignore the whole file if this comment is found anywhere therein |
canipls-ignore-start |
Start ignoring from this line |
canipls-ignore-end |
Stop ignoring after this line |
Examples
/* canipls-ignore-nextline */
@starting-style {
/* ... */
}
const now = Temporal.Now.instant(); // canipls-ignore
Config
canipls will search the following places for configuration options, in order of precedence:
- a file called
.canipls.cfg in the current project's root directory
- a file called
canipls.cfg in the user's global app config directory
- on Windows, this is found at
%HOME%/AppData/Roaming/canipls/
- on macOS and Linux, this is found at
~/.config/canipls/
- use the default values (see below table)
The following configuration options are available:
| name |
type |
default |
description |
support_threshold |
number |
90.0 |
The minimum global browser support threshold, according to caniuse, that features must meet |
show_low_support_warnings |
boolean |
true |
Whether to show warning diagnostics for features that fall below the desired support threshold. (If this is set to false, support_threshold has no effect.) |
Config files are simply plain text files containing one or more of the above config options, separated by newlines, with key/value pairs separated by a space:
support_threshold 80.0
show_low_support_warnings true
This project was researched, designed, and written completely by hand. Among other reasons, quality is a higher priority than quantity for this project. Pull requests that contain AI-generated content of any kind will be rejected.
