Skip to content

perf(parser): make pushing tokens faster#19960

Merged
graphite-app[bot] merged 1 commit intomainfrom
om/03-03-perf_parser_make_pushing_tokens_faster
Mar 3, 2026
Merged

perf(parser): make pushing tokens faster#19960
graphite-app[bot] merged 1 commit intomainfrom
om/03-03-perf_parser_make_pushing_tokens_faster

Conversation

@overlookmotel
Copy link
Member

@overlookmotel overlookmotel commented Mar 3, 2026

Use Vec::push_fast method (introduced in #19959) for pushing to the tokens Vec. We allocate sufficient capacity upfront in the Vec, so it should never need to grow.

Vec::push_fast makes the "need to grow" path cold and #[inline(never)], which should reduce the size of Lexer::finish_next, and help the branch predictor make accurate predictions.

+1% on benchmark for parsing with tokens in CodSpeed. Possible it'll have more impact in real world as CodSpeed doesn't take branch predictor into account in its simulations.

Copy link
Member Author

overlookmotel commented Mar 3, 2026


How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

  • 0-merge - adds this PR to the back of the merge queue
  • hotfix - for urgent hot fixes, skip the queue and merge this PR next

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

@github-actions github-actions bot added A-parser Area - Parser C-performance Category - Solution not expected to change functional behavior, only performance labels Mar 3, 2026
@overlookmotel overlookmotel force-pushed the om/03-03-feat_allocator_add_vec_push_fast_method branch from e31e409 to 5a987e9 Compare March 3, 2026 11:52
@overlookmotel overlookmotel force-pushed the om/03-03-perf_parser_make_pushing_tokens_faster branch from f0bd5c4 to 68eecce Compare March 3, 2026 11:52
@codspeed-hq
Copy link

codspeed-hq bot commented Mar 3, 2026

Merging this PR will not alter performance

✅ 53 untouched benchmarks
⏩ 3 skipped benchmarks1


Comparing om/03-03-perf_parser_make_pushing_tokens_faster (68eecce) with main (160e423)2

Open in CodSpeed

Footnotes

  1. 3 benchmarks were skipped, so the baseline results were used instead. If they were deleted from the codebase, click here and archive them to remove them from the performance reports.

  2. No successful run was found on om/03-03-feat_allocator_add_vec_push_fast_method (5a987e9) during the generation of this report, so main (160e423) was used instead as the comparison base. There might be some changes unrelated to this pull request in this report.

@overlookmotel overlookmotel marked this pull request as ready for review March 3, 2026 12:06
Copilot AI review requested due to automatic review settings March 3, 2026 12:06
@overlookmotel overlookmotel self-assigned this Mar 3, 2026
@overlookmotel overlookmotel added the A-linter-plugins Area - Linter JS plugins label Mar 3, 2026
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the lexer’s token collection hot path to use Vec::push_fast when appending tokens, aiming to reduce code size in Lexer::finish_next and improve branch prediction behavior during parsing.

Changes:

  • Switch token collection from self.tokens.push(token) to self.tokens.push_fast(token) in finish_next_inner.
  • Add an inline comment explaining why push_fast is expected to be beneficial here.

@graphite-app graphite-app bot added the 0-merge Merge with Graphite Merge Queue label Mar 3, 2026
@graphite-app
Copy link
Contributor

graphite-app bot commented Mar 3, 2026

Merge activity

Use `Vec::push_fast` method (introduced in #19959) for pushing to the tokens `Vec`. We allocate sufficient capacity upfront in the `Vec`, so it should never need to grow.

`Vec::push_fast` makes the "need to grow" path cold and `#[inline(never)]`, which should reduce the size of `Lexer::finish_next`, and help the branch predictor make accurate predictions.

+1% on benchmark for parsing with tokens in CodSpeed. *Possible* it'll have more impact in real world as CodSpeed doesn't take branch predictor into account in its simulations.
@graphite-app graphite-app bot force-pushed the om/03-03-feat_allocator_add_vec_push_fast_method branch from 5a987e9 to f83be30 Compare March 3, 2026 13:55
@graphite-app graphite-app bot force-pushed the om/03-03-perf_parser_make_pushing_tokens_faster branch from 68eecce to 8ba61dd Compare March 3, 2026 13:56
Base automatically changed from om/03-03-feat_allocator_add_vec_push_fast_method to main March 3, 2026 14:02
@graphite-app graphite-app bot removed the 0-merge Merge with Graphite Merge Queue label Mar 3, 2026
@graphite-app graphite-app bot merged commit 8ba61dd into main Mar 3, 2026
23 checks passed
@graphite-app graphite-app bot deleted the om/03-03-perf_parser_make_pushing_tokens_faster branch March 3, 2026 14:04
camc314 pushed a commit that referenced this pull request Mar 9, 2026
### 🚀 Features

- e8547cc parser: Report error for using declarations in ambient
contexts (#19934) (camc314)
- 8345318 allocator: Add methods for boxed slices `ArenaBox<[T]>`
(#19968) (overlookmotel)
- f83be30 allocator: Add `Vec::push_fast` method (#19959)
(overlookmotel)

### 🐛 Bug Fixes

- 291d867 transformer_plugins: Unwrap ChainExpression after define
replacement removes optional markers (#20058) (IWANABETHATGUY)
- 36b2e56 codegen: Print type for TSImportEqualsDeclaration (#20128)
(camc314)
- 5a246ec codegen: Print type arguments for JSXOpeningElement (#20127)
(camc314)
- a40870e codegen: Preserve parens for TSNonNullExpression (#20125)
(camc314)
- ae830b2 codegen: Print `declare` for `TSInterfaceDeclaration` (#20124)
(camc314)
- 92cfb14 linter/plugins: Fix types for `walkProgram` and
`walkProgramWithCfg` (#20081) (overlookmotel)
- ee0491e apps,napi: Explicitly specify libs in tsconfigs (#20071)
(camc314)
- 588009e codegen: Print `static` keyword for TSIndexSignature (#19755)
(Dunqing)
- 5a8799c codegen: Print `with_clause` for `ExportNamedDeclaration`
(#20002) (Dunqing)
- 7502afe parser: Correct capacity for tokens `Vec` (#19967)
(overlookmotel)

### ⚡ Performance

- 4ea8f9a napi: Remove `napi_build::setup()` from `oxc_napi` to avoid
redundant rebuilds (#20094) (Boshen)
- 2baa5fb napi: Unify build-test profile to coverage for cache sharing
(#20090) (Boshen)
- 8ba61dd parser: Make pushing tokens faster (#19960) (overlookmotel)

Co-authored-by: Boshen <1430279+Boshen@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-linter-plugins Area - Linter JS plugins A-parser Area - Parser C-performance Category - Solution not expected to change functional behavior, only performance

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants