GritQL [EXPERIMENTAL]
此内容尚不支持你的语言。
GritQL is a query language for performing structural searches on source code. This means that trivia such as whitespace or even the type of quotes used in strings will be ignored in your search query. In addition, it offers many features that allow you to query syntax structure such as snippets, matching, nesting, and variables.
GritQL is open-source and created by Grit.io.
Biome is integrating GritQL for two purposes:
- The
biome search
command, which we hope to extend to our IDE extensions as well. - Our currently in-progress plugin efforts.
Patterns
Section titled PatternsGritQL queries work through patterns. The most common pattern you will see is the code snippet, which looks like ordinary source code wrapped in backticks:
This pattern will match any call to console.log()
that is passed the string
'Hello, world!'
. But because GritQL does structural matching, it doesn’t
care about formatting details. This also matches:
And so does this (note the change in quotes):
Variables
Section titled VariablesGritQL queries can also have variables. The following will match any call to
console.log()
regardless of the message passed:
This will match any of the methods on the console
object too:
The same variable name can occur multiple times in a single snippet:
This will match foo && foo()
, and even foo.bar && foo.bar()
, but not
foo && bar()
.
Conditions
Section titled ConditionsYou can add conditions to patterns by using the where
operator. This is
commonly used together with the match operator, <:
:
This query is identical to the console.log($message)
pattern we saw earlier,
but it gets quickly more interesting when add other operators in the mix:
Language Documentation
Section titled Language DocumentationFor more information about GritQL and its syntax, see the official GritQL Language Documentation.
Please keep in mind that Biome doesn’t support all of Grit’s features (yet).
Integration Status
Section titled Integration StatusGritQL support in Biome is actively being worked on. Many things already work, but bugs are still expected and some features are still outright missing.
For a detailed overview of which GritQL features are supported and which are still in-progress, please see the GitHub issue: https://github.com/biomejs/biome/issues/2582.
We also have a detailed RFC which guides the direction for our plugin efforts: https://github.com/biomejs/biome/discussions/1762
tl;dr: We are working on supporting plugins, which can be either pure GritQL plugins or JS/TS plugins that use GritQL to select the code they wish to operate on. Stay tuned!