@jslint-org/jslint 2022.6.21 → 2022.7.20

package/CHANGELOG.md

@@ -1,8 +1,7 @@
 # Changelog
 
 # Todo
-- wrapper - add vscode-command to suppress minor warnings on given line
-- doc - document jslint directives and supported/unsupported es6+ features
+- doc - document supported/unsupported es6+ features
 - cli - remove cli-option `--mode-vim-plugin`
 - coverage - add macros `/*coverage-disable*/` and `/*coverage-enable*/`.
 - jslint - add html and css linting back into jslint.
@@ -14,6 +13,11 @@
 - jslint - add new warning "Expected Object.create(null) instead of {}"
 - node - after node-v14 is deprecated, remove shell-code `export "NODE_OPTIONS=--unhandled-rejections=strict"`.
 
+# v2022.7.20
+- bugfix - warnings that should be ignored sometimes suppress legitimate warnings
+- doc - document jslint directives
+- vscode - add extra contextmenu commands "JSLint - Do Not Lint Selected Region", "JSLint - Ignore Current Line"
+
 # v2022.6.21
 - directive - add new directive `subscript` for linting of scripts targeting Google Closure Compiler
 - bugfix - fix expression after "await" mis-identified as statement

package/README.md

@@ -3,7 +3,7 @@ Douglas Crockford <douglas@crockford.com>
 
 
 # Status
-| Branch | [master<br>(v2022.6.21)](https://github.com/jslint-org/jslint/tree/master) | [beta<br>(Web Demo)](https://github.com/jslint-org/jslint/tree/beta) | [alpha<br>(Development)](https://github.com/jslint-org/jslint/tree/alpha) |
+| Branch | [master<br>(v2022.7.20)](https://github.com/jslint-org/jslint/tree/master) | [beta<br>(Web Demo)](https://github.com/jslint-org/jslint/tree/beta) | [alpha<br>(Development)](https://github.com/jslint-org/jslint/tree/alpha) |
 |--:|:--:|:--:|:--:|
 | CI | [![ci](https://github.com/jslint-org/jslint/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/jslint-org/jslint/actions?query=branch%3Amaster) | [![ci](https://github.com/jslint-org/jslint/actions/workflows/ci.yml/badge.svg?branch=beta)](https://github.com/jslint-org/jslint/actions?query=branch%3Abeta) | [![ci](https://github.com/jslint-org/jslint/actions/workflows/ci.yml/badge.svg?branch=alpha)](https://github.com/jslint-org/jslint/actions?query=branch%3Aalpha) |
 | Coverage | [![coverage](https://jslint-org.github.io/jslint/branch-master/.artifact/coverage/coverage_badge.svg)](https://jslint-org.github.io/jslint/branch-master/.artifact/coverage/index.html) | [![coverage](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage/coverage_badge.svg)](https://jslint-org.github.io/jslint/branch-beta/.artifact/coverage/index.html) | [![coverage](https://jslint-org.github.io/jslint/branch-alpha/.artifact/coverage/coverage_badge.svg)](https://jslint-org.github.io/jslint/branch-alpha/.artifact/coverage/index.html) |
@@ -18,36 +18,59 @@ Douglas Crockford <douglas@crockford.com>
 
 2. [Web Demo Archived](#web-demo-archived)
 
-3. [API Doc](#api-doc)
-
-4. [Quickstart Install](#quickstart-install)
+3. [Quickstart Install](#quickstart-install)
     - [To install, just download and save https://www.jslint.com/jslint.mjs to file:](#to-install-just-download-and-save-httpswwwjslintcomjslintmjs-to-file)
     - [To run `jslint.mjs` in shell:](#to-run-jslintmjs-in-shell)
     - [To import `jslint.mjs` in ES Module environment:](#to-import-jslintmjs-in-es-module-environment)
     - [To import `jslint.mjs` in CommonJS environment:](#to-import-jslintmjs-in-commonjs-environment)
     - [To JSLint entire directory in shell:](#to-jslint-entire-directory-in-shell)
 
-5. [Quickstart JSLint Report](#quickstart-jslint-report)
+4. [Quickstart JSLint Report](#quickstart-jslint-report)
     - [To create a JSLint report in shell:](#to-create-a-jslint-report-in-shell)
     - [To create a JSLint report in javascript:](#to-create-a-jslint-report-in-javascript)
 
-6. [Quickstart V8 Coverage Report](#quickstart-v8-coverage-report)
+5. [Quickstart V8 Coverage Report](#quickstart-v8-coverage-report)
     - [To create V8 coverage report from Node.js / Npm program in shell:](#to-create-v8-coverage-report-from-nodejs--npm-program-in-shell)
     - [To create V8 coverage report from Node.js / Npm program in javascript:](#to-create-v8-coverage-report-from-nodejs--npm-program-in-javascript)
 
-7. [Quickstart JSLint in CodeMirror](#quickstart-jslint-in-codemirror)
-
-8. [Quickstart JSLint in Vim](#quickstart-jslint-in-vim)
-
-9. [Quickstart JSLint in VSCode](#quickstart-jslint-in-vscode)
-
-10. [Description](#description)
-
-11. [Package Listing](#package-listing)
-
-12. [Changelog](#changelog)
-
-13. [License](#license)
+6. [Quickstart JSLint in CodeMirror](#quickstart-jslint-in-codemirror)
+
+7. [Quickstart JSLint in Vim](#quickstart-jslint-in-vim)
+
+8. [Quickstart JSLint in VSCode](#quickstart-jslint-in-vscode)
+
+9. [Documentation](#documentation)
+    - [API Doc](#api-doc)
+    - [Directive `/*jslint*/`](#directive-jslint)
+        - [`/*jslint beta*/`](#jslint-beta)
+        - [`/*jslint bitwise*/`](#jslint-bitwise)
+        - [`/*jslint browser*/`](#jslint-browser)
+        - [`/*jslint convert*/`](#jslint-convert)
+        - [`/*jslint couch*/`](#jslint-couch)
+        - [`/*jslint devel*/`](#jslint-devel)
+        - [`/*jslint eval*/`](#jslint-eval)
+        - [`/*jslint for*/`](#jslint-for)
+        - [`/*jslint getset*/`](#jslint-getset)
+        - [`/*jslint indent2*/`](#jslint-indent2)
+        - [`/*jslint long*/`](#jslint-long)
+        - [`/*jslint node*/`](#jslint-node)
+        - [`/*jslint nomen*/`](#jslint-nomen)
+        - [`/*jslint single*/`](#jslint-single)
+        - [`/*jslint subscript*/`](#jslint-subscript)
+        - [`/*jslint this*/`](#jslint-this)
+        - [`/*jslint trace*/`](#jslint-trace)
+        - [`/*jslint unordered*/`](#jslint-unordered)
+        - [`/*jslint white*/`](#jslint-white)
+    - [Directive `/*global*/`](#directive-global)
+    - [Directive `/*property*/`](#directive-property)
+    - [Directive `/*jslint-disable*/.../*jslint-enable*/`](#directive-jslint-disablejslint-enable)
+    - [Directive `//jslint-ignore-line`](#directive-jslint-ignore-line)
+
+10. [Package Listing](#package-listing)
+
+11. [Changelog](#changelog)
+
+12. [License](#license)
 
 
 <br><br>
@@ -64,13 +87,6 @@ Douglas Crockford <douglas@crockford.com>
 - [Web Demo 2013 (ES5, CSS, HTML)](https://www.jslint.com/branch-v2013.3.13/jslint.html)
 
 
-<br><br>
-# API Doc
-- https://www.jslint.com/apidoc.html
-
-[![screenshot](https://jslint-org.github.io/jslint/branch-beta/.artifact/screenshot_browser__2f.artifact_2fapidoc.html.png)](https://www.jslint.com/apidoc.html)
-
-
 <br><br>
 # Quickstart Install
 
@@ -504,7 +520,9 @@ window.addEventListener("load", function () {
 
 
 <br><br>
-# Description
+# Documentation
+
+
 - [jslint.mjs](jslint.mjs) contains the jslint function. It parses and analyzes a source file, returning an object with information about the file. It can also take an object that sets options.
 
 - [index.html](index.html) runs the jslint.mjs function in a web page.
@@ -528,6 +546,324 @@ plays the part of a stern but benevolent editor, helping you to get the style
 right so that you can focus your creative energy where it is most needed.
 
 
+<br><br>
+### API Doc
+- https://www.jslint.com/apidoc.html
+
+[![screenshot](https://jslint-org.github.io/jslint/branch-beta/.artifact/screenshot_browser__2f.artifact_2fapidoc.html.png)](https://www.jslint.com/apidoc.html)
+
+
+<br><br>
+### Directive `/*jslint*/`
+
+<br>
+
+##### `/*jslint beta*/`
+
+```js
+/*jslint beta*/
+// Enable experimental warnings.
+// Warn if global variables are redefined.
+// Warn if const / let statements are not declared at top of function or
+//    script, similar to var statements.
+// Warn if const / let / var statements are not declared in ascii-order.
+// Warn if named-functions are not declared in ascii-order.
+```
+
+<br>
+
+##### `/*jslint bitwise*/`
+
+```js
+/*jslint bitwise*/
+// Allow bitwise operators.
+
+let foo = 0 | 1;
+```
+
+<br>
+
+##### `/*jslint browser*/`
+
+```js
+/*jslint browser*/
+// Assume browser environment.
+
+localStorage.getItem("foo");
+```
+
+<br>
+
+##### `/*jslint convert*/`
+
+```js
+/*jslint convert*/
+// Allow conversion operators.
+
+let foo = new Date() + "";
+let bar = !!0;
+```
+
+<br>
+
+##### `/*jslint couch*/`
+
+```js
+/*jslint couch*/
+// Assume CouchDb environment.
+
+registerType("text-json", "text/json");
+```
+
+<br>
+
+##### `/*jslint devel*/`
+
+```js
+/*jslint devel*/
+// Allow console.log() and friends.
+
+console.log("hello");
+```
+
+<br>
+
+##### `/*jslint eval*/`
+
+```js
+/*jslint eval*/
+// Allow eval().
+
+eval("1");
+```
+
+<br>
+
+##### `/*jslint for*/`
+
+```js
+/*jslint for*/
+// Allow for-loop.
+
+function foo() {
+    let ii;
+    for (ii = 0; ii < 10; ii += 1) {
+        foo();
+    }
+}
+```
+
+<br>
+
+##### `/*jslint getset*/`
+
+```js
+/*jslint getset, this, devel*/
+// Allow get() and set().
+
+let foo = {
+    bar: 0,
+    get getBar() {
+        return this.bar;
+    },
+    set setBar(value) {
+        this.bar = value;
+    }
+};
+console.log(foo.getBar); // 0
+foo.setBar = 1;
+console.log(foo.getBar); // 1
+```
+
+<br>
+
+##### `/*jslint indent2*/`
+
+```js
+/*jslint indent2*/
+// Use 2-space indent.
+
+function foo() {
+  return;
+}
+```
+
+<br>
+
+##### `/*jslint long*/`
+
+```js
+/*jslint long*/
+// Allow long lines.
+
+let foo = "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa";
+```
+
+<br>
+
+##### `/*jslint node*/`
+
+```js
+/*jslint node*/
+// Assume Node.js environment.
+
+require("fs");
+```
+
+<br>
+
+##### `/*jslint nomen*/`
+
+```js
+/*jslint nomen*/
+// Allow weird property names.
+
+let foo = {};
+foo._bar = 1;
+```
+
+<br>
+
+##### `/*jslint single*/`
+
+```js
+/*jslint single*/
+// Allow single-quote strings.
+
+let foo = '';
+```
+
+<br>
+
+##### `/*jslint subscript*/`
+
+```js
+/*jslint subscript*/
+// Allow identifiers in subscript-notation.
+
+let foo = {};
+foo["bar"] = 1;
+```
+
+<br>
+
+##### `/*jslint this*/`
+
+```js
+/*jslint this*/
+// Allow 'this'.
+
+function foo() {
+    return this;
+}
+```
+
+<br>
+
+##### `/*jslint trace*/`
+
+```js
+/*jslint trace*/
+// Include jslint stack-trace in warnings.
+
+console.log('hello world');
+/*
+1. Undeclared 'console'.
+console.log('hello world');
+Error
+    at warn_at (...)
+    at warn (...)
+    at lookup (...)
+    at pre_v (...)
+    at jslint.mjs
+2. Use double quotes, not single quotes.
+console.log(...);
+Error
+    at warn_at (...)
+    at lex_string (...)
+    at lex_token (...)
+    at jslint_phase2_lex (...)
+    at Function.jslint (...)
+    at jslint.mjs
+*/
+```
+
+<br>
+
+##### `/*jslint unordered*/`
+
+```js
+/*jslint unordered*/
+// Allow unordered cases, params, properties, and variables.
+
+let foo = {bb: 1, aa: 0};
+
+function bar({
+    bb = 1,
+    aa = 0
+}) {
+    return aa + bb;
+}
+```
+
+<br>
+
+##### `/*jslint white*/`
+
+```js
+/*jslint white*/
+// Allow messy whitespace.
+
+let foo = 1; let bar = 2;
+```
+
+
+<br><br>
+### Directive `/*global*/`
+
+```js
+/*global foo, bar*/
+// Declare global variables foo, bar.
+
+foo();
+bar();
+```
+
+
+<br><br>
+### Directive `/*property*/`
+
+```js
+/*property foo, bar*/
+// Restrict property-access to only .foo, .bar.
+
+let aa = {bar: 1, foo: 2};
+```
+
+
+<br><br>
+### Directive `/*jslint-disable*/.../*jslint-enable*/`
+
+```js
+/*jslint-disable*/
+
+JSLint will ignore and treat this region as blank-lines.
+Syntax error.
+
+/*jslint-enable*/
+```
+
+
+<br><br>
+### Directive `//jslint-ignore-line`
+
+```js
+// JSLint will ignore non-fatal warnings at given line.
+
+eval("1"); //jslint-ignore-line
+```
+
+
 <br><br>
 # Package Listing
 ![screenshot_package_listing.svg](https://jslint-org.github.io/jslint/branch-beta/.artifact/screenshot_package_listing.svg)

package/jslint.mjs

@@ -100,7 +100,7 @@
     catch_stack, causes, char, children, clear, closer, closure, code, column,
     concat, consoleError, console_error, console_log, constant, context,
     convert, count, coverageDir, create, cwd, d, dead, debugInline, default,
-    delta, devel, directive, directive_list, directive_quiet, directives,
+    delta, devel, directive, directive_ignore_line, directive_list, directives,
     dirname, disrupt, dot, edition, elem_list, ellipsis, else, end, endOffset,
     endsWith, entries, env, error, eval, every, example_list, excludeList, exec,
     execArgv, exit, exitCode, export_dict, exports, expression, extra, file,
@@ -153,7 +153,7 @@ let debugInline = (function () {
         return argv[0];
     }
     debug(); // Coverage-hack.
-    __consoleError = console.error;
+    __consoleError = console.error; //jslint-ignore-line
     return debug;
 }());
 let jslint_charset_ascii = (
@@ -165,7 +165,7 @@ let jslint_charset_ascii = (
     + "@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\]^_"
     + "`abcdefghijklmnopqrstuvwxyz{|}~\u007f"
 );
-let jslint_edition = "v2022.6.21";
+let jslint_edition = "v2022.7.20";
 let jslint_export;                      // The jslint object to be exported.
 let jslint_fudge = 1;                   // Fudge starting line and starting
                                         // ... column to 1.
@@ -860,11 +860,22 @@ function jslint(
             c,
             d
         );
-        if (the_token.warning === undefined) {
-            the_token.warning = the_warning;
-        } else {
+
+// Issue #408
+// Warnings that should be ignored sometimes suppress legitimate warnings.
+
+        if (the_warning.directive_ignore_line) {
+            return the_warning;
+        }
+
+// If there is already a warning on this token, suppress the new one. It is
+// likely that the first warning will be the most meaningful.
+
+        if (the_token.warning) {
             warning_list.pop();
+            return the_warning;
         }
+        the_token.warning = the_warning;
         return the_warning;
     }
 
@@ -1014,6 +1025,7 @@ function jslint(
             break;
 
 // PR-347 - Disable warning "missing_browser".
+//
 //         case "missing_browser":
 //             mm = `/*global*/ requires the Assume a browser option.`;
 //             break;
@@ -1098,6 +1110,7 @@ function jslint(
             break;
 
 // PR-347 - Disable warning "unexpected_directive_a".
+//
 //         case "unexpected_directive_a":
 //             mm = `When using modules, don't use directive '/\u002a${a}'.`;
 //             break;
@@ -1219,12 +1232,12 @@ function jslint(
         if (option_dict.trace) {
             warning.stack_trace = new Error().stack;
         }
-        if (warning.directive_quiet) {
+        if (warning.directive_ignore_line) {
 
 // test_cause:
-// ["0 //jslint-quiet", "semicolon", "directive_quiet", "", 0]
+// ["0 //jslint-ignore-line", "semicolon", "directive_ignore_line", "", 0]
 
-            test_cause("directive_quiet");
+            test_cause("directive_ignore_line");
             return warning;
         }
         warning_list.push(warning);
@@ -1328,6 +1341,7 @@ function jslint(
         );
 
 // PR-347 - Disable warning "missing_browser".
+//
 //         if (!option_dict.browser) {
 //             directive_list.forEach(function (comment) {
 //                 if (comment.directive === "global") {
@@ -2413,7 +2427,7 @@ function jslint_phase2_lex(state) {
         if (!option_dict.devel && jslint_rgx_todo.test(snippet)) {
 
 // test_cause:
-// ["//todo", "lex_comment", "todo_comment", "(comment)", 1] //jslint-quiet
+// ["//todo", "lex_comment", "todo_comment", "(comment)", 1] //jslint-ignore-line
 
             warn("todo_comment", the_comment);
         }
@@ -2700,6 +2714,7 @@ function jslint_phase2_lex(state) {
                     return char_after("]");
 
 // PR-362 - Relax regexp-warning against using <space>.
+//
 //                 case " ":
 //
 // // test_cause:
@@ -2780,6 +2795,7 @@ function jslint_phase2_lex(state) {
                     return;
 
 // PR-362 - Relax regexp-warning against using <space>.
+//
 //                 case " ":
 //
 // // test_cause:
@@ -3336,12 +3352,16 @@ console.log(JSON.stringify(Object.keys(window).sort(), undefined, 4));
 
                 "AbortController",
                 // "Buffer",
-                "DOMException",
+                // "Crypto",
+                // "CryptoKey",
                 "Event",
                 "EventTarget",
                 "MessageChannel",
                 "MessageEvent",
                 "MessagePort",
+                // "Request",
+                // "Response",
+                // "SubtleCrypto",
                 "TextDecoder",
                 "TextEncoder",
                 "URL",
@@ -3355,7 +3375,9 @@ console.log(JSON.stringify(Object.keys(window).sort(), undefined, 4));
                 "clearInterval",
                 "clearTimeout",
                 // "console",
+                // "crypto",
                 // "exports",
+                // "fetch",
                 // "global",
                 // "module",
                 "performance",
@@ -3365,7 +3387,6 @@ console.log(JSON.stringify(Object.keys(window).sort(), undefined, 4));
                 // "setImmediate",
                 "setInterval",
                 "setTimeout",
-                "structuredClone",
 
 // Web worker only.
 // https://github.com/mdn/content/blob/main/files/en-us/web/api
@@ -3408,6 +3429,7 @@ console.log(JSON.stringify(Object.keys(window).sort(), undefined, 4));
                 "sessionStorage",
                 // "setInterval",
                 // "setTimeout",
+                "structuredClone",
                 "window"
             ], "browser");
             break;
@@ -3469,6 +3491,7 @@ import https from "https";
 
         case "ecma":
             object_assign_from_list(global_dict, [
+                "AggregateError",
                 "Array",
                 "ArrayBuffer",
                 "Atomics",
@@ -3539,7 +3562,7 @@ import moduleHttps from "https";
     let result = "";
     await new Promise(function (resolve) {
         moduleHttps.get((
-            "https://raw.githubusercontent.com/nodejs/node/master/doc/api"
+            "https://raw.githubusercontent.com/nodejs/node/v16.x/doc/api"
             + "/globals.md"
         ), function (res) {
             res.on("data", function (chunk) {
@@ -3562,12 +3585,16 @@ import moduleHttps from "https";
             object_assign_from_list(global_dict, [
                 "AbortController",
                 "Buffer",
-                "DOMException",
+                // "Crypto",
+                // "CryptoKey",
                 "Event",
                 "EventTarget",
                 "MessageChannel",
                 "MessageEvent",
                 "MessagePort",
+                // "Request",
+                // "Response",
+                // "SubtleCrypto",
                 "TextDecoder",
                 "TextEncoder",
                 "URL",
@@ -3581,7 +3608,9 @@ import moduleHttps from "https";
                 "clearInterval",
                 "clearTimeout",
                 "console",
+                // "crypto",
                 "exports",
+                // "fetch",
                 "global",
                 "module",
                 "performance",
@@ -3590,8 +3619,7 @@ import moduleHttps from "https";
                 "require",
                 "setImmediate",
                 "setInterval",
-                "setTimeout",
-                "structuredClone"
+                "setTimeout"
             ], "Node.js");
             break;
         }
@@ -3658,7 +3686,7 @@ import moduleHttps from "https";
         ) {
 
 // test_cause:
-// ["/////////////////////////////////////////////////////////////////////////////////", "read_line", "too_long", "", 1] //jslint-quiet
+// ["/////////////////////////////////////////////////////////////////////////////////", "read_line", "too_long", "", 1] //jslint-ignore-line
 
             warn_at("too_long", line);
         }
@@ -3676,7 +3704,7 @@ import moduleHttps from "https";
 // Scan each line for following ignore-directives:
 // "/*jslint-disable*/"
 // "/*jslint-enable*/"
-// "//jslint-quiet"
+// "//jslint-ignore-line"
 
         if (line_source === "/*jslint-disable*/") {
 
@@ -3694,13 +3722,16 @@ import moduleHttps from "https";
                 stop_at("unopened_enable", line);
             }
             line_disable = undefined;
-        } else if (line_source.endsWith(" //jslint-quiet")) {
+        } else if (
+            line_source.endsWith(" //jslint-ignore-line")
+            || line_source.endsWith(" //jslint-quiet")
+        ) {
 
 // test_cause:
-// ["0 //jslint-quiet", "read_line", "jslint_quiet", "", 0]
+// ["0 //jslint-ignore-line", "read_line", "jslint_ignore_line", "", 0]
 
-            test_cause("jslint_quiet");
-            line_list[line].directive_quiet = true;
+            test_cause("jslint_ignore_line");
+            line_list[line].directive_ignore_line = true;
         }
         if (line_disable !== undefined) {
 
@@ -10214,7 +10245,7 @@ function v8CoverageListMerge(processCovs) {
             let resultTree;
             let rightChildren;
 
-// TODO(perf): Binary search (check overhead) //jslint-quiet
+// TODO(perf): Binary search (check overhead) //jslint-ignore-line
 
             while (ii < tree.children.length) {
                 child = tree.children[ii];
@@ -10292,7 +10323,7 @@ function v8CoverageListMerge(processCovs) {
 
 // This function will normalize-and-sort <funcCov>.ranges.
 // Sorts the ranges (pre-order sort).
-// TODO: Tree-based normalization of the ranges. //jslint-quiet
+// TODO: Tree-based normalization of the ranges. //jslint-ignore-line
 // @param funcCov Function coverage to normalize.
 
         funcCov.ranges = treeToRanges(treeFromSortedRanges(

package/jslint_wrapper_vscode.js

@@ -30,10 +30,11 @@
 /*property
     Diagnostic, DiagnosticSeverity, ProgressLocation, Warning, Window, activate,
     cancellable, character, clear, column, commands, createDiagnosticCollection,
-    document, end, exports, getText, increment, jslint, languages, line,
-    location, map, message, module, push, readFileSync,
-    registerTextEditorCommand, replace, report, runInNewContext, set, slice,
-    start, subscriptions, title, uri, warnings, window, withProgress
+    document, end, endsWith, exports, getText, increment, insert, isEmpty,
+    jslint, languages, line, lineAt, location, map, message, module, push,
+    range, rangeIncludingLineBreak, readFileSync, registerTextEditorCommand,
+    replace, report, runInNewContext, selection, set, slice, start,
+    subscriptions, title, uri, warnings, window, withProgress
 */
 
 "use strict";
@@ -82,6 +83,48 @@ function activate({
         });
     }
 
+    function jslintDisableRegion({
+        document,
+        selection
+    }, edit) {
+        let range;
+        let text;
+        edit.insert({
+            character: 0,
+            line: selection.start.line
+        }, "/*jslint-disable*/\n");
+        range = document.lineAt(selection.end).rangeIncludingLineBreak;
+        text = document.getText(range);
+
+// If selection-end is EOL without preceding line-break,
+// then prepend line-break before directive.
+
+        if (!text.endsWith("\n")) {
+            text += "\n/*jslint-enable*/";
+
+// If selection-end is start of a new line, then prepend directive before it.
+
+        } else if (!selection.isEmpty && selection.end.character === 0) {
+            text = "/*jslint-enable*/\n" + text;
+
+// Append directive to selection-end.
+
+        } else {
+            text += "/*jslint-enable*/\n";
+        }
+        edit.replace(range, text);
+    }
+
+    function jslintIgnoreLine({
+        document,
+        selection
+    }, edit) {
+        edit.insert({
+            character: document.lineAt(selection.end).range.end.character,
+            line: selection.end.line
+        }, " //jslint-ignore-line");
+    }
+
     function jslintLint({
         document
     }) {
@@ -148,7 +191,7 @@ function activate({
     require("vm").runInNewContext(
         (
             "\"use strict\";"
-            + require("fs").readFileSync( //jslint-quiet
+            + require("fs").readFileSync( //jslint-ignore-line
                 __dirname + "/jslint.mjs",
                 "utf8"
             ).replace(
@@ -170,6 +213,12 @@ function activate({
     subscriptions.push(vscode.commands.registerTextEditorCommand((
         "jslint.clear"
     ), jslintClear));
+    subscriptions.push(vscode.commands.registerTextEditorCommand((
+        "jslint.disableRegion"
+    ), jslintDisableRegion));
+    subscriptions.push(vscode.commands.registerTextEditorCommand((
+        "jslint.ignoreLine"
+    ), jslintIgnoreLine));
     subscriptions.push(vscode.commands.registerTextEditorCommand((
         "jslint.lint"
     ), jslintLint));

package/package.json

@@ -33,5 +33,5 @@
         "test2": "sh jslint_ci.sh shCiBase"
     },
     "type": "module",
-    "version": "2022.6.21"
+    "version": "2022.7.20"
 }