Analyzer
New features
-
Add partial for
.astro
files. Biome is able to sort imports inside the frontmatter of the Astro files. Contributed
by @ematipico--- - import { getLocale } from "astro:i18n"; - import { Code } from "astro:components"; + import { Code } from "astro:components"; + import { getLocale } from "astro:i18n"; --- <div></div>
-
Add partial for
.vue
files. Biome is able to sort imports inside the script block of Vue files. Contributed by
@nhedger<script setup lang="ts"> - import Button from "./components/Button.vue"; - import * as vueUse from "vue-use"; + import * as vueUse from "vue-use"; + import Button from "./components/Button.vue"; </script/> <template></template>
-
Add partial for
.svelte
files. Biome is able to sort imports inside the script block of Svelte files. Contributed by
@ematipico<script setup lang="ts"> - import Button from "./components/Button.svelte"; - import * as svelteUse from "svelte-use"; + import * as svelteUse from "svelte-use"; + import Button from "./components/Button.svelte"; </script/> <div></div>
-
Add lint rule useJsxKeyInIterable from Eslint rule
react/jsx-key
. Contributed by @vohoanglong0107 -
The analyzer now infers the correct quote from
javascript.formatter.quoteStyle
, if set. This means that code fixes suggested by the analyzer will use the same quote of the formatter. Contributed by @ematipico
Enhancements
-
noUnusedVariables ignores unused rest spread silbings.
The following code is now valid:
const { a, ...rest } = { a: 0, b: 1 }; console.log(rest);
Contributed by @ah-yu
-
Fix #1931. Built-in React hooks such as
useEffect()
can now be validated by the
useExhaustiveDependendies
, even
when they're not being imported from the React library. To do so, simply configure them like
any other user-provided hooks.Contributed by @arendjr
-
Implemented #1128. User-provided React hooks can
now be configured to track stable results. For example:"useExhaustiveDependencies": { "level": "error", "options": { "hooks": [{ "name": "useMyState", "stableResult": [ 1 ] }] } }
This will allow the following to be validated:
const [myState, setMyState] = useMyState(); const toggleMyState = useCallback(() => { setMyState(!myState); }, [myState]); // Only `myState` needs to be specified here.
Contributed by @arendjr
Bug fixes
-
Fix #1748. Now for the following case we won't provide an unsafe fix
for thenoNonNullAssertion
rule:x[y.z!];
Contributed by @ah-yu
-
Imports that contain the protocol
:
are now sorted after thenpm:
modules, and before theURL
modules.
Contributed by @ematipicoimport express from "npm:express"; - import Component from "./component.js" - import { sortBy } from "virtual:utils"; + import { sortBy } from "virtual:utils"; + import Component from "./component.js"
-
Fix #1081. The
useAwait
rule does not reportfor await...of
.
Contributed by @unvalley -
Fix #1827 by properly analyzing nested
try-finally
statements. Contributed by @ah-yu -
Fix #1924 Use the correct export name to sort in the import clause. Contributed by @ah-yu
-
Fix #1805 fix formatting arrow function which has conditional expression body Contributed by @mdm317
-
Fix #1781 by avoiding the retrieval of the entire static member expression for the reference if the static member expression does not start with the reference. Contributed by @ah-yu
CLI
New features
-
Add a new command
biome migrate prettier
. The command will read the file.prettierrc
/prettier.json
and.prettierignore
and map its configuration to Biome's one.
Due to the different nature of.prettierignore
globs and Biome's globs, it's highly advised to make sure that
those still work under Biome. -
Now the file name printed in the diagnostics is clickable. If you run the CLI from your editor, you can
Ctrl/⌘ + Click on the file name, and the editor will open said file. If row and columns
are specified e.g.file.js:32:7
, the editor will set the cursor right in that position. Contributed by @ematipico -
Add an option
--linter
tobiome rage
. The option needs to check Biome linter configuration. Contributed by
@seitarof -
Add an option
--formatter
tobiome rage
. The option needs to check Biome formatter configuration. Contributed by
@seitarof -
The CLI now consistently reports the number of files tha were changed, out of the total files that were analysed. Contributed by @ematipico
-
The CLI now consistently shows the number of errors and warnings emitted. Contributed by @ematipico
Bug fixes
-
Don't process files under an ignored directory.
Previously, Biome processed all files in the traversed hierarchy,
even the files under an ignored directory.
Now, it completely skips the content of ignored directories.For now, directories cannot be ignored using
files.include
in the configuration file.
This is a known limitation that we want to address in a future release.For instance, if you have a project with a folder
src
and a foldertest
,
the following configuration doesn't completely ignoretest
.{ "files": { "include": ["src"] } }
Biome will traverse
test
,
however all files of the directory are correctly ignored.
This can result in file system errors,
if Biome encounters dangling symbolic links or files with higher permissions.To avoid traversing the
test
directory,
you should ignore the directory usingignore
:{ "files": { "include": ["src"], "ignore": ["test"] } }
-
Fix #1508 by excluding deleted files from being processed. Contributed
by @ematipico -
Fix #1173. Fix the formatting of a single instruction with commented
in a control flow body to ensure consistency. Contributed by @mdm317 -
Fix overriding of
javascript.globals
. Contributed by @arendjr -
Fix a bug where syntax rules weren't run when pulling the diagnostics. Now Biome will emit more parsing diagnostics,
e.g.check.js:1:17 parse/noDuplicatePrivateClassMembers ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ × Duplicate private class member "#foo" > 1 │ class A { #foo; #foo } │ ^^^^
Contributed by @ematipico
-
Fix #1774 by taking into account the option
--no-errors-on-unmatched
when running the CLI using--changed
. Contributed by @antogyn
Enhancements
-
Removed a superfluous diagnostic that was printed during the linting/check phase of a file:
test.js check ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ × The file contains diagnostics that needs to be addressed.
Contributed by @ematipico
-
The command
format
now emits parsing diagnostics if there are any, and it will terminate with a non-zero exit code. Contributed by @ematipico
Configuration
New features
-
Add the ability to resolve the configuration files defined inside
extends
from thenode_modules/
directory.If you want to resolve a configuration file that matches the specifier
@org/configs/biome
, then yourpackage.json
file must look this:{ "name": "@org/configs", "exports": { "./biome": "./biome.json" } }
And the
biome.json
file that "imports" said configuration, will look like this:{ "extends": "@org/configs/biome" }
Read the documentation to better understand how it
works, expectations and restrictions.
Editors
Bug fixes
- Fix a regression where ignored files where formatted in the editor. Contributed by @ematipico
- Fix a bug where syntax rules weren't run when pulling the diagnostics. Now Biome will emit more parsing diagnostics,
e.g.
Contributed by @ematipicocheck.js:1:17 parse/noDuplicatePrivateClassMembers ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ × Duplicate private class member "#foo" > 1 │ class A { #foo; #foo } │ ^^^^
Formatter
New features
-
Biome now allows to format the
package.json
file. This is now the default behaviour and users can remove their
workarounds.
If you rely on other tools to formatpackage.json
, you'll have to ignore it via configuration. Contributed by
@pattrickrice -
New formatter option
attributePosition
that have similar behavior as
PrettiersingleAttributePerLine
#1706. Contributed by @octoshikari -
Add partial for
.astro
files. Biome is able to format the frontmatter of the Astro files. Contributed by @ematipico--- - statement ( ); + statement(); --- <div></div>
-
Add partial for
.vue
files. Biome is able to format the script block of Vue files. Contributed by @nhedger<script setup lang="ts"> - statement ( ); + statement(); </script/> <template></template>
-
Add partial for
.svelte
files. Biome is able to format the script block of Svelte files. Contributed by @ematipico<script setup lang="ts"> - statement ( ); + statement(); </script/> <div></div>
Enhancements
-
composer.json
,deno.json
,jsconfig.json
,package.json
andtsconfig.json
are no longer protected files.This means that you can now format them.
If you want to ignore these files, you can use the files.ignore configuration:
{ "files": { "ignore": [ "composer.json", "jsconfig.json", "package.json", "tsconfig.json", "typescript.json", "deno.json", "deno.jsonc" ] } }
The following files are still protected, and thus ignored:
composer.lock
npm-shrinkwrap.json
package-lock.json
yarn.lock
Contributed by @pattrickrice and @Conaclos
Bug fixes
-
Fix #1039. Check unicode width instead of number of bytes when
checking if regex expression is a simple argument.This no longer breaks.
s(/🚀🚀/).s().s();
Contributed by @kalleep
-
Fix #1218, by correctly preserving empty lines in member chains.
Contributed by @ah-yu -
Fix #1659 and #1662, by correctly taking into account the leading comma inside the formatter options. Contributed by @ematipico
-
Fix #1934. Fix invalid formatting of long arrow function for AsNeeded arrow parens Contributed by @fireairforce
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:
- complexity/noEmptyTypeParameters
- complexity/noUselessLoneBlockStatements
- correctness/noInvalidUseBeforeDeclaration
- correctness/noUnusedImports
- correctness/noUnusedPrivateClassMembers
- security/noGlobalEval
- style/useConsistentArrayType
- style/useExportType
- style/useFilenamingConvention
- style/useForOf
- style/useImportType
- style/useNodejsImportProtocol
- style/useNumberNamespace
- style/useShorthandFunctionType
- suspicious/noEmptyBlockStatements
- suspicious/noGlobalAssign
- suspicious/noMisleadingCharacterClass
- suspicious/noThenProperty
- suspicious/useAwait
Additionally, the following rules are now recommended:
Removed rules
-
Remove
nursery/useGroupedTypeImport
. The rule style/useImportType covers the behavior of this rule.Note that removing a nursery rule is not considered a breaking change according to our semantic versioning.
Contributed by @Conaclos
New features
-
Add the rule noSkippedTests, to disallow skipped tests:
describe.skip("test", () => {}); it.skip("test", () => {});
Contributed by @ematipico
-
Add the rule noFocusedTests, to disallow skipped tests:
describe.only("test", () => {}); it.only("test", () => {});
Contributed by @ematipico
-
Add rule useSortedClasses, to sort CSS utility classes:
- <div class="px-2 foo p-4 bar" /> + <div class="foo·bar·p-4·px-2" />
Contributed by @DaniGuardiola
-
Add rule noUndeclaredependencies, to detect the use of
dependencies that aren't present in thepackage.json
.The rule ignores imports using a protocol such as
node:
,bun:
,jsr:
,https:
.Contributed by @ematipico and @Conaclos
-
Add rule noNamespaceImport, to report namespace imports:
import * as foo from "foo";
Contributed by @unvalley
-
Add partial support for
.astro
files. Biome is able to lint and fix the frontmatter of the Astro files. Contributed
by @ematipico--- - delete a.b + a.b = undefined --- <div></div>
-
Add partial support for
.vue
files. Biome is able to lint and fix the script block of the Vue files.<script setup lang="ts"> - delete a.b + a.b = undefined <script> <template></template>
Contributed by @nhedger
-
Add rule useNodeAssertStrict, which promotes the use
ofnode:assert/strict
overnode:assert
. Contributed by @ematipico -
Add rule noExportsInTest which disallows
export
ormodules.exports
in files
containing test. Contributed by @ah-yu -
Add rule noSemicolonInJsx to detect possible wrong semicolons inside JSX elements.
const Component = () => { return ( <div> <div />; </div> ); }
Contributed by @fujiyamaorange
-
Add rule noBarrelFile, to report the usage of barrel file:
export * from "foo";
Contributed by @togami2864
Enhancements
-
noUselessFragments now rule not triggered for jsx attributes when
the fragment child is simple text.export function SomeComponent() { return <div x-some-prop={<>Foo</>} />; }
Also fixes code action when the fragment child is of type
JsxExpressionChild
.<> <Hello leftIcon={<>{provider?.icon}</>} /> {<>{provider?.icon}</>} <>{provider?.icon}</> </>
Contributed by @vasucp1207
-
noUselessTernary now provides unsafe code fixes. Contributed by
@vasucp1207 -
noApproximativeNumericConstant now provides
unsafe code fixes and handle numbers without leading zero and numbers with digit separators.The following numbers are now reported as approximated constants.
3.14_15; // PI .4342; // LOG10E
Contributed by @Conaclos
-
noPrecisionLoss no longer reports number with extra zeros.
The following numbers are now valid.
.1230000000000000000000000; 1230000000000000000000000.0;
Contributed by @Conaclos
-
useNamingConvention now
supports unicase
letters (#1786).unicase letters have a single case: they are neither uppercase nor lowercase.
Previously, Biome reported names in unicase as invalid.
It now accepts a name in unicase everywhere.The following code is now accepted:
const 안녕하세요 = { 안녕하세요: 0 };
We still reject a name that mixes unicase characters with lowercase or uppercase characters:
The following names are rejected:const A안녕하세요 = { a안녕하세요: 0 };
Contributed by @Conaclos
-
useNamingConvention
and useFilenamingConvention now provides a new optionrequireAscii
to require identifiers to
be in ASCII.To avoid any breaking change, this option is turned off by default.
We intend to turn it on in the next major release of Biome (Biome 2.0).Set the
requireAscii
rule option totrue
to require identifiers to be in ASCII.{ "linter": { "rules": { "style": { "useNamingConvention": { "options": { "requireAscii": false } } }, "nursery": { "useFilenamingConvention": { "options": { "requireAscii": false } } } } } }
Contributed by @Conaclos
-
noUnusedVariables no longer reports unused imports.
We now have a dedicated rule for reporting unused imports:
noUnusedImportsContributed by @Conaclos
Bug fixes
-
Fix missing link in noStaticOnlyClass documentation.
Contributed by @yndajas -
noConfusingVoidType no longer reports valid use of the void
type in conditional types (#1812).The rule no longer reports the following code:
type Conditional<T> = T extends void ? Record<string, never> : T
Contributed by @lucasweng
-
noInvalidUseBeforeDeclaration no longer reports
valid use of binding patterns (#1648).The rule no longer reports the following code:
const { a = 0, b = a } = {};
Contributed by @Conaclos
-
noUnusedVariables no longer reports used binding
patterns (#1652).The rule no longer reports
a
as unused the following code:const { a = 0, b = a } = {}; export { b };
Contributed by @Conaclos
-
Fix #1651. noVar now
ignores TsGlobalDeclaration. Contributed by @vasucp1207 -
Fix #1640. useEnumInitializers code action now generates valid code when last member has a comment but no comma. Contributed by @kalleep
-
Fix #1653. Handle a shorthand value in
useForOf
to avoid the false-positive case. Contributed by @togami2864 -
Fix #1656. useOptionalChain code action now correctly handles logical and chains where methods with the same name are invoked with different arguments:
- tags·&&·tags.includes('a')·&&·tags.includes('b') + tags?.includes('a') && tags.includes('b')
Contributed by @lucasweng
-
Fix #1704. Convert
/
to escaped slash\/
to avoid parsing error in
the result of autofix. Contributed by @togami2864 -
Fix#1697. Preserve leading trivia in autofix of suppression rules.
Contributed by @togami2864 -
Fix #603. Trim trailing whitespace to avoid double insertion.
Contributed by @togami2864 -
Fix #1765. Now the rule
noDelete
doesn't trigger when deleting a
dataset:delete element.dataset.prop;
Contributed by @ematipico
-
useNamingConvention
and useFilenamingConvention now reject identifiers with consecutive delimiters.The following name is now invalid because it includes two underscores:
export const MY__CONSTANT = 0;
Note that we still allow consecutive leading and consecutive trailing underscores.
Contributed by @Conaclos
-
Fix #1932 Allow redeclaration of type parameters in different declarations.
Contributed by @keita-hino -
Fix #1945 Allow constructor with default parameters in
noUselessConstructor
-
Fix #1982 Change to iterate over the module item lists and ignore .d.ts files. Contributed by @togami2864
Parser
Bug fixes
-
Fix #1728. Correctly parse the global declaration when the
{
token
is on the line following theglobal
keyword.Now the following code is correctly parsed:
declare global { } declare module foo { global { } }
Contributed by @ah-yu
-
Fix #1730. Correctly parse
delete
expressions with operands that are
not simple member expressions.delete(a.b); delete console.log(1); delete(() => {});
Contributed by @printfn
Website
Bug fixes
- Fix #1981. Identify TypeScript definition files by their file path within the playground. Contributed by @ah-yu
What's Changed
Other changes
- fix: concurrency deadlock by @ematipico in #1980
- Add GritQL grammar by @arendjr in #1951
- fix: website favicon by @Sec-ant in #1989
- feat(cli): add
--stdio
argument tolsp-proxy
command by @nhedger in #1997
Full Changelog: cli/v1.5.3-nightly.4fa841c...cli/v1.6.0