Skip to main content
Branch on a stable code, never on message text. Every failure envelope carries one E_* code from a single table. Codes may be added, never renamed or removed, apart from the one move to W_* below. The message beside a code is free copy and may change in any release. From the release after 4.1.41, a warning carries a W_* code: the run carried on past it. Errors and refusals keep their E_* code. See Warning codes. The table ships as extension-develop/contract/codes.json, see Result envelope.

Usage

Project

Manifest

Compile

E_COMPILE and E_FIRST_COMPILE are the top-level codes of a failed compile. Thirteen rows above travel inside that frame’s error.details, one per error: E_MODULE_NOT_FOUND, E_CONTENT_SCRIPT_SYNTAX, E_INLINE_SCRIPT_SYNTAX, E_CSS_PARSE, E_ENTRY_NOT_FOUND, E_ASSET_MISSING, E_SCRIPT_DEP_MISSING, E_RESERVED_FOLDER, E_CSS_PREPROCESSOR_MISSING, E_CSS_DEAD_REF, E_LOCALES_LAYOUT, E_WAR_INVALID, and E_PERF_BUDGET. Up to 4.2.0, E_BACKGROUND_REQUIRED could appear there too. A warning in details has severity: "warning" and a W_* code. A successful build’s warnings strings open with the same W_CODE: prefix. See Compile diagnostics.

Remote projects and network

Browser binary and launch

Browser runtime

Debug protocol

From the release after 4.1.41, a CDP fault after launch that leaves the session ready carries the warning name instead: W_CDP_NOT_CONNECTED, W_CDP_TIMEOUT, W_CDP_OP_FAILED, W_BROWSER_CONNECTION_CLOSED, or W_EXTENSION_ID_UNKNOWN. That covers ready.json cdpFaultCode too.

Dev server

Ready contract

Control channel

Logs

Create

Everything else

Warning codes

From the release after 4.1.41, every coded warning carries a W_* code. It shows on an error.details entry with severity: "warning", at the start of each warnings string, and in ready.json cdpFaultCode. A class that can fail and warn has one code under each prefix with the same stem, such as E_PERF_BUDGET and W_PERF_BUDGET. Releases up to 4.1.41 reported many of these warnings under the E_* name with the same stem, such as E_CSS_DEAD_REF. A script that matches a warning by code reads W_ in place of E_. No alias exists.

Folded and legacy names

codes.json carries two extra mappings beside the table:
  • folded maps finer inventory names onto a shipped family code. For example E_ARG_REQUIRED folds onto E_ARGS, and E_BROWSER_NOT_INSTALLED folds onto E_BROWSER_NOT_FOUND.
  • Eleven E_* names that only ever marked a warning fold onto their W_* name, such as E_PORT_IN_USE. Nothing reports them now.
  • legacy maps the three pre-envelope conventions onto the table. Snake_case ready.json codes (profile_locked to E_PROFILE_LOCKED), PascalCase error names (TargetNotFound to E_TARGET_NOT_FOUND), and kebab-case doctor check ids (eval-token to E_TOKEN_MISSING).
If your consumer meets a name outside the table, resolve it through these mappings before branching.

Next steps