Analyzer
Bug fixes
-
Now Biome can detect the script language in Svelte and Vue script blocks more reliably (#2245). Contributed by @Sec-ant
-
useExhaustiveDependencies
no longer reports recursive calls as missing
dependencies (#2361).
Contributed by @arendjr -
useExhaustiveDependencies
correctly reports missing dependencies declared
using function declarations (#2362).
Contributed by @arendjr -
Biome now can handle
.svelte
and.vue
files withCRLF
as the end-of-line sequence. Contributed by @Sec-ant -
noMisplacedAssertion
no longer reports method calls bydescribe
,test
,it
objects (e.g.test.each([])()
) (#2443). Contributed by @unvalley. -
Biome now can handle
.vue
files with generic components (#2456).<script generic="T extends Record<string, any>" lang="ts" setup> //... </script>
Contributed by @Sec-ant
Enhancements
-
Complete the well-known file lists for JSON-like files. Trailing commas are allowed in
.jsonc
files by default. Some well-known files liketsconfig.json
and.babelrc
don't use the.jsonc
extension but still allow comments and trailing commas. While others, such as.eslintrc.json
, only allow comments. Biome is able to identify these files and adjusts thejson.parser.allowTrailingCommas
option accordingly to ensure they are correctly parsed. Contributed by @Sec-ant -
Fix dedent logic inconsistent with prettier where the indent-style is space and the indent-width is not 2. Contributed by @mdm317
CLI
New features
-
Add a command to migrate from ESLint
biome migrate eslint
allows you to migrate an ESLint configuration to Biome.
The command supports legacy ESLint configurations and new flat ESLint configurations.
Legacy ESLint configurations using the YAML format are not supported.When loading a legacy ESLint configuration, Biome resolves the
extends
field.
It resolves both shared configurations and plugin presets!
To do this, it invokes Node.js.Biome relies on the metadata of its rules to determine the equivalent rule of an ESLint rule.
A Biome rule is either inspired or roughly identical to an ESLint rules.
By default, inspired and nursery rules are excluded from the migration.
You can use the CLI flags--include-inspired
and--include-nursery
to migrate them as well.Note that this is a best-effort approach.
You are not guaranteed to get the same behavior as ESLint.Given the following ESLint configuration:
{ "ignore_patterns": ["**/*.test.js"], "globals": { "var2": "readonly" }, "rules": { "eqeqeq": "error" }, "overrides": [{ "files": ["lib/*.js"], "rules": { "default-param-last": "off" } }] }
biome migrate eslint --write
changes the Biome configuration as follows:{ "linter": { "rules": { "recommended": false, "suspicious": { "noDoubleEquals": "error" } } }, "javascript": { "globals": ["var2"] }, "overrides": [{ "include": ["lib/*.js"], "linter": { "rules": { "style": { "useDefaultParameterLast": "off" } } } }] }
Also, if the working directory contains
.eslintignore
, then Biome migrates the glob patterns.
Nested.eslintignore
in subdirectories and negated glob patterns are not supported.If you find any issue, please don't hesitate to report them.
Contributed by @Conaclos
-
Added two new options to customise the emitted output of the CLI:
--reporter=json
and--reporter=json-pretty
. With--reporter=json
, the diagnostics and the
summary will be printed in the terminal in JSON format. With--reporter=json-pretty
, you can print the same information, but formatted using the same options of your configuration.NOTE: the shape of the JSON is considered experimental, and the shape of the JSON might change in the future.
Example of output when running `biome format` command
```json { "summary": { "changed": 0, "unchanged": 1, "errors": 1, "warnings": 0, "skipped": 0, "suggestedFixesSkipped": 0, "diagnosticsNotPrinted": 0 }, "diagnostics": [ { "category": "format", "severity": "error", "description": "Formatter would have printed the following content:", "message": [ { "elements": [], "content": "Formatter would have printed the following content:" } ], "advices": { "advices": [ { "diff": { "dictionary": " statement();\n", "ops": [ { "diffOp": { "delete": { "range": [0, 2] } } }, { "diffOp": { "equal": { "range": [2, 12] } } }, { "diffOp": { "delete": { "range": [0, 2] } } }, { "diffOp": { "equal": { "range": [12, 13] } } }, { "diffOp": { "delete": { "range": [0, 2] } } }, { "diffOp": { "insert": { "range": [13, 15] } } } ] } } ] }, "verboseAdvices": { "advices": [] }, "location": { "path": { "file": "format.js" }, "span": null, "sourceCode": null }, "tags": [], "source": null } ], "command": "format" } ``` -
Added new
--staged
flag to thecheck
,format
andlint
subcommands.This new option allows users to apply the command only to the files that are staged (the
ones that will be committed), which can be very useful to simplify writing git hook scripts
such aspre-commit
. Contributed by @castarco
Enhancements
-
Improve support of
.prettierignore
when migrating from PrettierNow, Biome translates most of the glob patterns in
.prettierignore
to the equivalent Biome ignore pattern.
Only negated glob patterns are not supported.Contributed by @Conaclos
-
Support JavaScript configuration files when migrating from Prettier
biome migrate prettier
is now able to migrate Prettier configuration files
ending withjs
,mjs
, orcjs
extensions.
To do this, Biome invokes Node.js.Also, embedded Prettier configurations in
package.json
are now supported.Contributed by @Conaclos
-
Support
overrides
field in Prettier configuration files when migrating from Prettier.
Contributed by @Conaclos -
Support passing a file path to the
--config-path
flag or theBIOME_CONFIG_PATH
environment variable.Now you can pass a
.json
/.jsonc
file path with any filename to the--config-path
flag or the
BIOME_CONFIG_PATH
environment variable. This will disable the configuration auto-resolution and Biome
will try to read the configuration from the said file path (#2265).biome format --config-path=../biome.json ./src
Contributed by @Sec-ant
Bug fixes
-
Biome now tags the diagnostics emitted by
organizeImports
andformatter
with correct severity levels, so they will be properly filtered by the flag--diagnostic-level
(#2288). Contributed by @Sec-ant -
Biome now correctly filters out files that are not present in the current directory when using the
--changed
flag #1996. Contributed by @castarco -
Biome now skips traversing
fifo
orsocket
files (#2311). Contributed by @Sec-ant -
Biome now resolves configuration files exported from external libraries in
extends
from the working directory (CLI) or project root (LSP). This is the documented behavior and previous resolution behavior is considered as a bug (#2231). Contributed by @Sec-ant
Configuration
Bug fixes
-
Now setting group level
all
tofalse
can disable recommended rules from that group when top levelrecommended
istrue
or unset. Contributed by @Sec-ant -
Biome configuration files can correctly extends
.jsonc
configuration files now (#2279). Contributed by @Sec-ant -
Fixed the JSON schema for React hooks configuration (#2396). Contributed by @arendjr
Enhancements
-
Biome now displays the location of a parsing error for its configuration file (#1627).
Previously, when Biome encountered a parsing error in its configuration file,
it didn't indicate the location of the error.
It now displays the name of the configuration file and the range where the error occurred.Contributed by @Conaclos
-
options
is no longer required for rules without any options (#2313).Previously, the JSON schema required to set
options
tonull
when an object is used to set the diagnostic level of a rule without any option.
However, ifoptions
is set tonull
, Biome emits an error.The schema is now fixed and it no longer requires specifying
options
.
This makes the following configuration valid:{ "linter": { "rules": { "style": { "noDefaultExport": { "level": "off" } } } } }
Contributed by @Conaclos
Editors
Bug fixes
- Biome extension is now able to parse the JSX syntax in files that associated with the
javascript
language identifier. This is an ad hoc fix, because in the React world,.js
files are allowed to include JSX syntax, and these files are often associated with thejavascript
language identifier in most of the editors. Plus, some editor extensions will also associate.jsx
files with thejavascript
language identifier. Relative links: discussion, #2085. Contributed by @Sec-ant
Formatter
Bug fixes
- Fix #2291 by correctly handle comment placement for JSX spread attributes and JSX spread children. Contributed by @ah-yu
JavaScript APIs
Linter
Promoted rules
New rules are incubated in the nursery group.
Once stable, we promote them to a stable group.
The following rules are promoted:
- complecity/noExcessiveNestedTestSuites
- complexity/noUselessTernary
- correctness/useJsxKeyInIterable
- performance/noBarrelFile
- performance/noReExportAll
- style/noNamespaceImport
- style/useNodeAssertStrict
- suspicious/noDuplicateTestHooks
- suspicious/noExportsInTest
- suspicious/noFocusedTests
- suspicious/noSkippedTests
- suspicious/noSuspiciousSemicolonInJsx
New features
-
Add a new option
jsxRuntime
to thejavascript
configuration. When set toreactClassic
, the noUnusedImports and useImportType rules use this information to make exceptions for the React global that is required by the React Classic JSX transform.This is only necessary for React users who haven't upgraded to the new JSX transform.
-
Implement #2043: The React rule
useExhaustiveDependencies
is now also compatible with Preact hooks imported frompreact/hooks
orpreact/compat
. Contributed by @arendjr -
Add rule noFlatMapIdentity to disallow unnecessary callback use on
flatMap
. Contributed by @isnakode -
Add rule noConstantMathMinMaxClamp, which disallows using
Math.min
andMath.max
to clamp a value where the result itself is constant. Contributed by @mgomulak
Enhancements
-
style/useFilenamingConvention now allows prefixing a filename with
+
(#2341).This is a convention used by Sveltekit and Vike.
Contributed by @Conaclos
-
style/useNamingConvention now accepts
PascalCase
for local and top-level variables.This allows supporting local variables that hold a component or a regular class.
The following code is now accepted:function loadComponent() { const Component = getComponent(); return <Component />; }
Contributed by @Conaclos
-
complexity/useLiteralKeys no longer report computed properties named
__proto__
(#2430).In JavaScript,
{["__proto__"]: null}
and{__proto__: null}
have not the same semantic.
The first code set a regular property tonull
.
The second one set the prototype of the object tonull
.
See the MDN Docs for more details.The rule now ignores computed properties named
__proto__
.Contributed by @Conaclos
Bug fixes
-
Lint rules
useNodejsImportProtocol
,useNodeAssertStrict
,noRestrictedImports
,noNodejsModules
will no longer checkdeclare module
statements anymore. Contributed by @Sec-ant -
style/useNamingConvention now accepts any case for variables from object destructuring (#2332).
The following name is now ignored:
const { Strange_Style } = obj;
Previously, the rule renamed this variable. This led to a runtime error.
Contributed by @Conaclos
Parser
Bug fixes
- Fixed an issue when Unicode surrogate pairs were encoded in JavaScript strings
using an escape sequence (#2384).
Contributed by @arendjr
What's Changed
Other changes
- chore: derive
Diagnostic
onenum
by @arendjr in #2282 - feat(css_formatter): ValueListLayout::SingleLine by @denbezrukov in #2226
- Describe multi-root workspace limitation in docs by @smikitky in #2297
- refactor(project): new crate biome_configuration by @unvalley in #2269
- refactor(biome_deserialize): replace
is_type()
withvisitable_type()
by @Conaclos in #2310 - feat: graphql lexer by @vohoanglong0107 in #2271
- docs: add warning around nested config by @ematipico in #2318
- feat(cli): generic reporter APIs by @ematipico in #853
- fix(js_analyzer): add graphics-symbol role by @drwpow in #2294
- fix(lint):
noSvgWithoutTitle
valid case to usearia-hidden
correctly by @unvalley in #2340 - fix(lint/useExhaustiveDependencies): unintended application of stable custom hook rules by @fluffy-takagi in #2328
- refactor(linter): allow multiple rule sources by @Conaclos in #2336
- chore(use-number-namespace.md): fix typo by @arienshibani in #2155
- docs(website): Getting Started and Formatter improvements by @Conaclos in #2379
- chore(website): add
yaml
&graphql
to language support & sync table rows by @afonsojramos in #2363 - docs: fix the broken link in analyzer/index.mdx by @ganta in #2400
- feat(biome_css_analyze): implement
noDuplicateFontNames
by @togami2864 in #2308 - chore: add Grit patterns crate by @arendjr in #2275
- docs: update useForOf to include a relevant example by @DeJayDev in #2429
- chore(benchmark): update eslint to v9 by @chansuke in #2431
- fix: update the extension in the code block of the docs by @togami2864 in #2436
- docs: suggest biome migrate commands after biome init by @Conaclos in #2437
- docs(useImportType): add caveat section by @Conaclos in #2444
- refactor(codegen): reduce Git conflicts using slices instead of arrays by @Conaclos in #2446
- chore(deps): update rust crate insta to 1.38.0 by @renovate in #2451
- chore(deps): update pnpm to v8.15.7 by @renovate in #2449
- chore(deps): update @biomejs packages by @renovate in #2448
- chore(deps): update rust crate quote to 1.0.36 by @renovate in #2450
- chore: update xtask/bench readme by @mdm317 in #2423
New Contributors
- @smikitky made their first contribution in #2297
- @castarco made their first contribution in #2319
- @drwpow made their first contribution in #2294
- @github-actions made their first contribution in #2334
- @fluffy-takagi made their first contribution in #2328
- @arienshibani made their first contribution in #2155
- @afonsojramos made their first contribution in #2363
- @ganta made their first contribution in #2400
- @DeJayDev made their first contribution in #2429
- @mgomulak made their first contribution in #2404
- @isnakode made their first contribution in #2324
Full Changelog: cli/v1.6.4...cli/v1.7.0