// Before:
import * as ts from "typescript";
// The full typescript module graph evaluates here
function compileFile(path) {
const program = ts.createProgram([path], {});
}import defer / notebook
import defer
Runnable notebook: every JavaScript, HTML and CSS example on this page executes in a sandboxed local frame. Nothing leaves the browser.
// After:
import defer * as ts from "typescript";
// No code is evaluated; potentially faster startup
function compileFile(path) {
// The typescript module graph evaluates when `ts.createProgram`
// is accessed, i.e., when `compileFile` is called.
// If `compileFile` is never called, then the module graph
// is never evaluated.
const program = ts.createProgram([path], {});
}import defer * as ts from "typescript";
// No code is evaluated
import * as ts2 from "typescript";
// The full typescript module graph evaluates here
function compileFile(path) {
// Accessing `ts.createProgram` no longer evaluates the subgraph
// because it's already evaluated.
const program = ts.createProgram([path], {});
}import * as mod from "./module.js";
import text from "./module.js" with { type: "text" };// -- squares.js --
console.log("Initializing squares");
const squares = Array.from({ length: 10000 }, (_, index) => index ** 2);
export function getSquare(index) {
return squares[index];
}// -- main.js --
import defer * as squares from "./squares.js";
console.log("Ready");
export function showSquare(index) {
console.log(squares.getSquare(index));
}
showSquare(3); // Logs "Initializing squares", then 9
showSquare(4); // Logs 16; initialization is not repeated// -- config.js --
export const locale = await Promise.resolve("en-US");
console.log("Configuration ready");// -- format.js --
console.log("Formatting module evaluated");
export function format(value, locale) {
return new Intl.NumberFormat(locale).format(value);
}// -- report.js --
import { locale } from "./config.js";
import { format } from "./format.js";
console.log("Report module evaluated");
export function createReport(value) {
return format(value, locale);
}// -- main.js --
import defer * as report from "./report.js";
console.log("Main module evaluated");
console.log(report.createReport(1000));// -- broken.js --
export const value = 1;
throw new Error("Initialization failed");// -- main.js --
import defer * as broken from "./broken.js";
for (let attempt = 0; attempt < 2; attempt++) {
try {
console.log(broken.value);
} catch (error) {
console.log(error.message); // "Initialization failed" on both attempts
}
}// -- features.js --
import defer * as report from "./report.js";
export { report };// -- main.js --
import { report } from "./features.js";
// Accessing an export through report triggers its deferred evaluation.
console.log(report.createReport(1000));