Measuring code size

Opening the dialog

The tooltip of the menu item reads "Local code size, with deployment measurements when routes are available." and "Deployed route: Shift click". The menu item is hidden in embedded playgrounds; the palette item and the shortcut remain. From a script, edge.size.open() opens it. A failure while opening shows as a toast.

What the dialog shows

• A header with Size, a Local / Deployed toggle, hidden for Deployed when there are no routes, and the v1 URL and v2 URL sizes.
• A thin progress bar, then the Route and Version selects, for Deployed only, and a status line.
• The size of the source and its line count, the date of the deployment or version, and its deployment note in quotes.
• The Composition panel, the Filter files field and the file table.
• The worker section and the worker:fs assets.
• A legend and a list of keys, and the buttons Close, Refresh and Copy as text.

The URL sizes are the complete UTF-8 bytes of the playground URL, in its plain form (v1) and in its compressed form (v2, #v=2&c=…). Local marks the encoding in use as Active: v2 once the raw state reaches 8,192 characters and v2 is shorter. Deployed measures the saved URL of the version and marks the encoding that was Stored. See Linking and embedding.

Local measurement

Local needs no routes, no history and no deployed files. It measures:

• the editor source: UTF-8 bytes and lines, split by the content type of the exports (js, css, html, svg, json, wasm, txt, xml, bin, or the first four letters of another subtype) plus markup, so the parts add up to exactly the source;
• every o: export, with its path, type, bytes and SHA-256, found with the playground's own extractor;
• the worker bundle, built with the same compiler that initializes the output, which may fetch imports;
• each import the worker loaded, fetched again three at a time, with a status: net for a measured one, shared for a duplicate, external, changed when the body no longer matches the compiled hash, or HTTP n or failed;
• the worker:fs assets, and the number of edge:remove and edge:redact elements.

The local composition is the source document plus the separately generated worker bundle. The dialog says so: "Export sizes are already included in the source document. Included adds the separately generated worker bundle." The second sentence appears only when the code has a <script type=worker>. The status line reads "Local source", "Local source + bundled worker", "Estimated · bundling local worker" or "Estimated · local worker bundle unavailable", and adds "Some import sizes unavailable" when that applies.

Deployed measurement

Deployed, for the current deployment, measures one route: the one chosen in the Route select.

• Fetching. The root and every export are fetched from https://<route>/, three at a time, anonymously: with no cookies and no cache. Because the requests are anonymous, a route that restricts access to signed-in visitors may report ✗.
• Retries. A network error, an HTTP 5xx and a 429 are retried up to 5 times, after 1, 2, 4, 8 and 16 seconds, with the parallelism dropping to 1. A 404 is final.
• What counts as deployed. A response counts as deployed only if it is OK and carries the platform's deploy response header, an ISO timestamp. A file that answers OK without it gets ✗, its size cell shows "HTTP 200", and the tooltip reads "answered without a deploy header — not a deployed file".
• Wire bytes. They come from Resource Timing. On rt.ht routes, the platform lets rtcode.io read the transfer size, and the encoding shows in the column title, for example wire·zstd. If the browser reports no encoded size, for example on a domain without that permission, the wire cell shows "–" with the tooltip "wire size not reported".
• Worker imports. They are crawled transitively to a depth of 4, with at most 32 modules fetched. Beyond that, a module reads "not fetched".
• The worker bundle. The exact deployed bundle is shown to allow-listed owners only. Otherwise the row shows "n/a", and the worker size is an estimate.
• Date and note. They come from the newest saved version. The dialog waits at most 4 seconds for it.

Saved versions

In Deployed mode, the Version select lists "Current deployment" and the newest 100 saved versions, each as "date · sha7 · deleted · note". A script can also pick a version by its index, 0 for the newest, or by a unique prefix of its SHA. See Versions and undo.

• Archived data only. Measuring a version reads only archived bodies: the source, the root payload, the export payloads, the worker source and bundle, and the worker:fs assets. It sends no live request and does not change the editor. Changing the route resets the selection to Current deployment.
• The note. The dialog says "Archived payload excludes HTML added by the edge when serving. Historical transfer sizes are unavailable."
• The archive legend. ▣ archived, or "attempted", shown as !, for a failed deployment attempt; – unavailable; ⚑ complete or partial, where "known byte totals exclude unavailable archive bodies"; ≈ gzip calculated from archived bodies; ! archive issues.

Reading the report

From a script

The dialog is a front end for edge.size(). Run these from io.eval.js or the playground tab's DevTools console. See edge.size() for the full reference.

edge.size(options)

Returns a promise of the JSON report. It measures the first route of Code.D by default, or Local when there are no routes.

edge.size.text(options)

Returns the aligned text report, as Copy as text does. Besides the options below, it takes units ('human' or 'bytes'), order ('size' or 'doc'), cols (132 by default), q, a path substring filter, and off, a Set of content types to leave out.

edge.size.local()

Returns a snapshot of what the source would deploy, with no network use: no deployed fetches, no import resolution and no bundle.

edge.size.open(options)

Opens the dialog, on Local by default and on Deployed when you pass a version. It works without routes.

The options of edge.size() are mode, where 'local' forces Local and any other value means Deployed when a route is available, route, one of Code.D, version, refresh and signal. A version is 'current' for the live deployment, a non-negative integer for the n-th newest of the newest 100 saved versions, or a hexadecimal SHA prefix of 1 to 40 characters that must match exactly one version. A string of digits such as '2' is a SHA prefix, not an index. The promise rejects for a bad combination: "A saved version requires Deployed mode.", "A saved version requires a deployment route.", "Unknown deployment route: <route>", "Unknown deployment version: <ref>" and "Ambiguous deployment version: <ref>".

const { total, exports, worker, complete } = await edge.size({ mode: 'local' });
({ total, exports, worker, complete })

await edge.size.text({ mode: 'local', units: 'bytes', order: 'doc', cols: 100, off: new Set(['markup']) })

const live = await edge.size(), saved = await edge.size({ version: 0 });
({ live: live.total, saved: saved.total, issues: saved.issues })

await edge.size.open({ mode: 'deployed', route: Code.D[0], version: 1 })   // the dialog on the second-newest saved version

Browser requirements

Code Size uses CompressionStream with gzip, Resource Timing, Intl.NumberFormat unit formatting and URL.parse(), which it needs to resolve export paths and worker imports. The v2 URL size also needs Uint8Array base64 support. Without it, only the URL sizes show "URL sizes unavailable: …". See Browser support.

See also

• edge.size()
• edge
• Versions and undo
• Deploying
• Exporting files
• Using workers
• Linking and embedding
• Keyboard shortcuts