mirror of
https://github.com/oxc-project/oxc.git
synced 2026-09-14 19:36:11 +08:00
overlookmotel
ea2880170a
Add benchmarks for source maps in `oxc-codegen`. 2 benchmarks: 1. Full end-to-end. 2. Without the actual sourcemap generation at the end. The 2nd is to measure the overhead that pushing to the sourcemap arrays adds while printing in isolation.
53 lines
2.4 KiB
TypeScript
53 lines
2.4 KiB
TypeScript
// A fast JavaScript code generator from an ESTree-compliant AST.
|
|
//
|
|
// A faithful port of Oxc's Rust `oxc_codegen` crate (pretty-printing mode).
|
|
// Output is byte-identical to `oxc_codegen` with default options (tab indentation, double quotes, comments off).
|
|
//
|
|
// The printer is one function per construct, split across this directory by area.
|
|
// `printStatement` in `statement.ts` and `printExpression` in `expression.ts` are the two dispatch
|
|
// points the rest hangs off.
|
|
//
|
|
// Reference: `oxc/crates/oxc_codegen/src/{gen.rs,lib.rs,str.rs,binary_expr_visitor.rs}`
|
|
|
|
import { debugAssert, typeAssertIs } from "../asserts.ts";
|
|
import { generateSourceMap } from "./source_map.ts";
|
|
import { printProgram, printStatement } from "./statement.ts";
|
|
|
|
import type { CodegenResult, Options } from "./options.ts";
|
|
import type { State } from "../state.ts";
|
|
import type * as ESTree from "../../../../npm/oxc-types/types.d.ts";
|
|
|
|
/**
|
|
* Print `node`, returning an object including the generated code.
|
|
*
|
|
* One of these exists per build. The package entry point picks the build and calls it -
|
|
* callers of the package never reach this directly.
|
|
*
|
|
* The result is an object so that further outputs (a source map) can be added without a breaking change.
|
|
*
|
|
* @param state - Created by the entry point, so that all 4 builds share one class and so one object shape
|
|
* @param options - The same options `state` was created from, for the parts only this build acts on
|
|
* @returns Object holding the generated code
|
|
*/
|
|
export function printSync(node: ESTree.Node, state: State, options: Options): CodegenResult {
|
|
if (node.type === "Program") {
|
|
printProgram(node, state);
|
|
} else {
|
|
typeAssertIs<ESTree.Statement>(node);
|
|
printStatement(node, state);
|
|
}
|
|
|
|
// This is removed by minifier in non-sourcemap builds.
|
|
//
|
|
// The `skipSourcemapGeneration` check exists only in benchmark builds -
|
|
// everywhere else `BENCHMARKS` is `false` and the condition folds back to `SOURCEMAPS` alone.
|
|
// The option is deliberately not in `Options` - types are documentation, and it is not public API.
|
|
// @ts-expect-error `skipSourcemapGeneration` is benchmarks-only, so is not in `Options`
|
|
if (SOURCEMAPS && (!BENCHMARKS || !options.skipSourcemapGeneration)) {
|
|
debugAssert(options.sourcemap === true, "`options.sourcemap` should be true in a maps build");
|
|
return { code: state.output, map: generateSourceMap(state, options) };
|
|
}
|
|
|
|
return { code: state.output, map: null };
|
|
}
|