Analyzer
Enhancements
CLI
New features
-
Add a new option
--rule
to the commandbiome lint
(#58).This new option allows you to execute a single rule or a rule group.
This option is convenient to test a rule or apply the code fixes of a single rule.For example, you can execute the
style/useNamingConvention
rule on the working directory:biome lint --rule=style/useNamingConvention ./
If the rule has a code action (autofix), you can use
--apply
to apply the fix:biome lint --rule=style/useNamingConvention --apply ./
The option takes the rule options in the Biome configuration file into account.
Only, the severity level of the rule is overridden by its default value,
i.e.error
for a recommended rule orwarn
otherwise.You can also run a group of rules:
biome lint --rule=suspicious src/main.js
In this case, the severity level of a rule is not overridden.
Thus, the disabled rules stay disabled.
To ensure that the group is run, therecommended
field of the group is turned on.
Thenursery
group cannot be passed because no rules are enabled in the nursery group by default.The option is compatible with other options such as
--apply
,--apply-unsafe
and--reporter
.Contributed by @Conaclos
-
Add new command
biome clean
. Use this command to purge all the logs emitted by the Biome daemon. This command is really useful, because the Biome daemon tends
log many files and contents during its lifecycle. This means that if your editor is open for hours (or even days), thebiome-logs
folder could become quite heavy. Contributed by @ematipico -
Add support for formatting and linting CSS files from the CLI. These operations are opt-in for the time being.
If you don't have a configuration file, you can enable these features with
--css-formatter-enabled
and--css-linter-enabled
:biome check --css-formatter-enabled=true --css-linter-enabled=true ./
Contributed by @ematipico
-
Add new CLI options to control the CSS formatting. Check the CLI reference page for more details. Contributed by @ematipico
-
Add new options
--write
,--fix
(alias of--write
) and--unsafe
to the commandbiome lint
andbiome check
.
Add a new option--fix
(alias of--write
) to the commandbiome format
andbiome migrate
.biome <lint|check> --<write|fix> [--unsafe] biome format --<write|fix> biome migrate --<write|fix>
The
biome <lint|check> --<write|fix>
has the same behavior asbiome <lint|check> --apply
.
Thebiome <lint|check> --<write|fix> --unsafe
has the same behavior asbiome <lint|check> --apply-unsafe
.
Thebiome format --fix
has the same behavior asbiome format --write
.
Thebiome migrate --fix
has the same behavior asbiome migrate --write
.This change allows these commands to write modifications in the same options.
With this change, the--apply
and--apply-unsafe
options are deprecated.Contributed by @unvalley
Enhancements
-
Biome now executes commands (lint, format, check and ci) on the working directory by default. #2266 Contributed by @unvalley
- biome check . + biome check # You can run the command without the path
-
biome migrate eslint
now tries to convert ESLint ignore patterns into Biome ignore patterns.ESLint uses gitignore patterns.
Biome now tries to convert these patterns into Biome ignore patterns.For example, the gitignore pattern
/src
is a relative path to the file in which it appears.
Biome now recognizes this and translates this pattern to./src
.Contributed by @Conaclos
-
biome migrate eslint
now supports theeslintIgnore
field inpackage.json
.ESLint allows the use of
package.json
as an ESLint configuration file.
ESLint supports two fields:eslintConfig
andeslintIgnore
.
Biome only supported the former. It now supports both.Contributed by @Conaclos
-
biome migrate eslint
now propagates NodeJS errors to the user.This will help users to identify why Biome is unable to load some ESLint configurations.
Contributed by @Conaclos
-
Add a new
--reporter
calledsummary
. This reporter will print diagnostics in a different way, based on the tools (formatter, linter, etc.) that are executed.
Import sorting and formatter shows the name of the files that require formatting. Instead, the linter will group the number of rules triggered and the number of errors/warnings:Formatter ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ The following files needs to be formatted: main.ts index.ts Organize Imports ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ The following files needs to have their imports sorted: main.ts index.ts Analyzer ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ Some analyzer rules were triggered Rule Name Diagnostics lint/suspicious/noImplicitAnyLet 12 (12 error(s), 0 warning(s), 0 info(s)) lint/suspicious/noDoubleEquals 8 (8 error(s), 0 warning(s), 0 info(s)) lint/suspicious/noRedeclare 12 (12 error(s), 0 warning(s), 0 info(s)) lint/suspicious/noDebugger 20 (20 error(s), 0 warning(s), 0 info(s))
Contributed by @ematipico
-
biome ci
now enforces printing the output using colours. If you were previously using--colors=force
, you can remove it because it's automatically set. Contributed by @ematipico
Configuration
New features
-
Add an rule option
fix
to override the code fix kind of a rule (#2882).A rule can provide a safe or an unsafe code action.
You can now tune the kind of code actions thanks to thefix
option.
This rule option takes a value among:none
: the rule no longer emits code actions.safe
: the rule emits safe code action.unsafe
: the rule emits unsafe code action.
The following configuration disables the code actions of
noUnusedVariables
, makes the emitted code actions ofstyle/useConst
andstyle/useTemplate
unsafe and safe respectively.{ "linter": { "rules": { "correctness": { "noUnusedVariables": { "level": "error", "fix": "none" }, "style": { "useConst": { "level": "warn", "fix": "unsafe" }, "useTemplate": { "level": "warn", "fix": "safe" } } } } } }
Contributed by @Conaclos
-
Add option
javascript.linter.enabled
to control the linter for JavaScript (and its super languages) files. Contributed by @ematipico -
Add option
json.linter.enabled
to control the linter for JSON (and its super languages) files. Contributed by @ematipico -
Add option
css.linter.enabled
to control the linter for CSS (and its super languages) files. Contributed by @ematipico -
Add option
css.formatter
, to control the formatter options for CSS (and its super languages) files. Contributed by @ematipico
Enhancements
- The
javascript.formatter.trailingComma
option is deprecated and renamed tojavascript.formatter.trailingCommas
. The corresponding CLI option--trailing-comma
is also deprecated and renamed to--trailing-commas
. Details can be checked in #2492. Contributed by @Sec-ant
Editors
New features
- Add support for LSP Workspaces
Bug fixes
- Fixes #2781, by correctly computing the configuration to apply to a specific file. Contributed by @ematipico
Formatter
Bug fixes
- Fix #2470 by avoid introducing linebreaks in single line string interpolations. Contributed by @ah-yu
- Resolve deadlocks by narrowing the scope of locks. Contributed by @mechairoi
- Fix #2782 by computing the enabled rules by taking the override settings into consideration. Contributed by @ematipico
JavaScript APIs
Linter
New features
-
Add nursery/useThrowOnlyError. Contributed by @minht11
-
Add nursery/useImportExtensions. Contributed by @minht11
-
useNamingConvention now supports an option to enforce custom conventions (#1900).
For example, you can enforce the use of a prefix for private class members:
{ "linter": { "rules": { "style": { "useNamingConvention": { "level": "error", "options": { "conventions": [ { "selector": { "kind": "classMember", "modifiers": ["private"] }, "match": "_(.*)", "formats": ["camelCase"] } ] } } } } } }
Please, find more details in the rule documentation.
Contributed by @Conaclos
-
Add nursery/useNumberToFixedDigitsArgument.
Contributed by @minht11 -
Add nursery/useThrowNewError.
Contributed by @minht11 -
Add nursery/useTopLevelRegex, which enforces defining regular expressions at the top level of a module. #2148 Contributed by @dyc3.
-
Add nursery/noCssEmptyBlock. #2513 Contributed by @togami2864
-
Add nursery/noDuplicateAtImportRules. #2658 Contributed by @DerTimonius
-
Add nursery/noDuplicateFontNames. #2308 Contributed by @togami2864
-
Add nursery/noDuplicateSelectorsKeyframeBlock. #2534 Contributed by @isnakode
-
Add nursery/noImportantInKeyframe. #2542 Contributed by @isnakode
-
Add nursery/noInvalidPositionAtImportRule. #2717 Contributed by @t-shiratori
-
Add nursery/noUnknownFunction. #2570 Contributed by @neokidev
-
Add nursery/noUnknownMediaFeatureName. #2751 Contributed by @Kazuhiro-Mimaki
-
Add nursery/noUnknownProperty. #2755 Contributed by @chansuke
-
Add nursery/noUnknownSelectorPseudoElement. #2655 Contributed by @keita-hino
-
Add nursery/noUnknownUnit. #2535 Contributed by @neokidev
-
Add nursery/noUnmatchableAnbSelector. #2706 Contributed by @togami2864
-
Add nursery/useGenericFontNames. #2573 Contributed by @togami2864
-
Add nursery/noYodaExpression. Contributed by @michellocana
Enhancements
-
Add a code action for noConfusingVoidType and improve the diagnostics.
The rule now suggests using
undefined
instead ofvoid
in confusing places.
The diagnosis is also clearer.Contributed by @Conaclos
Bug fixes
-
noUndeclaredVariables and noUnusedImports now correctly handle import namespaces (#2796).
Previously, Biome bound unqualified type to import namespaces.
Import namespaces can only be used as qualified names in a type (ambient) context.// Unused import import * as Ns1 from ""; // This doesn't reference the import namespace `Ns1` type T1 = Ns1; // Undeclared variable `Ns1` // Unused import import type * as Ns2 from ""; // This doesn't reference the import namespace `Ns2` type T2 = Ns2; // Undeclared variable `Ns2` import type * as Ns3 from ""; // This references the import namespace because it is a qualified name. type T3 = Ns3.Inner; // This also references the import namespace. export type { Ns3 }
Contributed by @Conaclos
-
noUndeclaredVariables now ignores
this
in JSX components (#2636).The rule no longer reports
this
as undeclared in following code.import { Component } from 'react'; export class MyComponent extends Component { render() { return <this.foo /> } }
-
useJsxKeyInIterable
now handles more cases involving fragments. See the snippets below. Contributed by @dyc3
// valid
[].map((item) => {
return <>{item.condition ? <div key={item.id} /> : <div key={item.id}>foo</div>}</>;
});
// invalid
[].map((item) => {
return <>{item.condition ? <div /> : <div>foo</div>}</>;
});
noExcessiveNestedTestSuites
no longer erroneously alerts ondescribe
calls that are not invoking the globaldescribe
function. #2599 Contributed by @dyc3
// now valid
z.object({})
.describe('')
.describe('')
.describe('')
.describe('')
.describe('')
.describe('');
-
noExportsInTest rule no longer treats files with in-source testing as test files #2859. Contributed by @ah-yu
-
useSortedClasses now keeps leading and trailing spaces when applying the code action inside template literals:
i Unsafe fix: Sort the classes. 1 1 │ <> 2 │ - → <div·class={`${variable}·px-2·foo·p-4·bar`}/> 2 │ + → <div·class={`${variable}·foo·bar·p-4·px-2`}/> 3 3 │ <div class={`px-2 foo p-4 bar ${variable}`}/> 4 4 │ </>
-
noUndeclaredDependencies is correctly triggered when running
biome ci
. Contributed by @ematipico -
noUnusedVariables no longer panics when a certain combination of characters is typed. Contributed by @ematipico
Parser
Enhancements
Bug fixes
-
The
const
modifier for type parameters is now accepted for TypeScriptnew
signatures (#2825).The following code is now correctly parsed:
interface I { new<const T>(x: T): T }
Contributed by @Conaclos
-
Some invalid TypeScript syntax caused the Biome parser to crash.
The following invalid syntax no longer causes the Biome parser to crash:
declare using x: null; declare qwait using x: null;
Contributed by @Conaclos
What's Changed
Other changes
- ci: fix nightly version and restore update of manifest by @ematipico in #2953
Full Changelog: js-api/v0.6.0-nightly.af70ac2...cli/v1.7.4-nightly.125f34b