ErrorLens README

Welcome to ErrorLens.

ErrorLens enhances Visual Studio Code's inbuilt diagnostic highlighting. Visual Studio Code's default behavior is to underline errors and warnings and other diagnostic messages using a 'squiggly underline'. Whilst this is certainly useful, the underline visual effect is subtle, and therefore can be easily overlooked in a busy file.

ErrorLens turbo-charges the language diagnostic features, by making diagnostics stand out more prominently, highlighting the entire line wherever a diagnostic is generated by the language and also prints the diagnostic message(s) in-line at the site of the line of code which is generating the diagnostic.

Deprecation Note

Error Lens was originally conceived and developed by Phil Hindle.

I no longer maintain this extension. A fork of this repo has been developed greatly since I stopped working on this in 2019. I recommend installing Alexander's fork of this extension from https://marketplace.visualstudio.com/items?itemName=usernamehw.errorlens (Repo URL for the extension is: https://github.com/usernamehw/vscode-error-lens)

Features

• Lines containing errors or warnings or info are highlighted more obviously.
• Diagnostic descriptions are appended to the end of any line containing diagnostic info, meaning that you do not have to context-switch to the problem view.
• The status bar shows the number of diagnostics for the open file. (This can be configured)
• Settings can be configured to control the way ErrorLens displays enhanced diagnostics.
• Works for any language which provides diagnostics.

Requirements

Built using Visual Studio Code 1.31.

Tested on Windows 10 (64-bit), Linux Mint & OSX 10.13.

Extension Settings

This extension contributes the following settings:

• errorLens.errorColor: The background color used to highlight lines containing errors. (Alpha component can be used)
• errorLens.errorTextColor: The text color used to highlight lines containing errors. (Alpha component can be used)
• errorLens.warningColor: The background color used to highlight lines containing warnings. (Alpha component can be used)
• errorLens.warningTextColor: The text color used to highlight lines containing warnings. (Alpha component can be used)
• errorLens.infoColor: The background color used to highlight lines containing info. (Alpha component can be used)
• errorLens.infoTextColor: The text color used to highlight lines containing info. (Alpha component can be used)
• errorLens.hintColor: The background color used to highlight lines containing hints. (Alpha component can be used)
• errorLens.hintTextColor: The text color used to highlight lines containing hints. (Alpha component can be used)
• errorLens.fontStyle: Show ErrorLens annotations in Italics, or not?
• errorLens.fontWeight: Specifies the font weight for ErrorLens annotations.
• errorLens.fontMargin: Distance between end of the code line, and the start of the ErrorLens annotation. (CSS units)
• errorLens.enabledDiagnosticLevels: Customize which diagnostic levels to highlight.
• errorLens.statusBarControl: Customize how the VS Code Status Bar shows errors and warnings.
• errorLens.addAnnotationTextPrefixes: If 'true', prefixes the diagnostic severity ('Error:', 'Warning:' etc) to ErrorLens annotations.

Extension Commands

This extension contributes the following commands:

• ErrorLens.enable: Enable ErrorLens.
• ErrorLens.disable: Disable ErrorLens.

Contributing & contacting the author

The project is hosted on Github at: https://github.com/phindle/error-lens. Please submit suggestions, bug reports, Pull Requests and so on here.

I'm occasionally on Twitter @GeekyMcGeekface

Known Issues

None known.

Release Notes

Please refer to CHANGELOG.md for more details.

1.1.0

Second release of ErrorLens (February 2019).

NOTE: Configuration property errorLens.errorMsgPrefix has been removed. The reason is that this was somewhat unnecessary, and just added noise to the annotations. (cf. #9)

1.0.0

Initial release of ErrorLens (October 2018)