Reference
Diagnostic codes
The stable codes of diagnostics. Search for a code on this page or run yassb docs diagnostics.
| Code | Meaning | Reported by |
|---|---|---|
CONFIG_LOAD_FAILED | The configuration (config/*.ts|js|json) or a module it imports threw while loading. | behaviour.site-code, config.files |
CONFIG_MODULE_NOT_FOUND | The configuration imports a package that is not installed in the site. | config.files |
CONFIG_UNSUPPORTED_FILE | A config file has a format YASSB 2 does not read (yaml, toml, …). | config.files |
UNDECLARED_DEPENDENCY | Site code imports a package missing from package.json (it may work only by accident). | cli.check |
COMPONENT_NOT_FOUND | A `component` directive points to a file that does not exist. | directive.component |
COMPONENT_UNSUPPORTED_FORMAT | A `component` directive points to a file type that cannot be included. | directive.component |
COMPONENT_CYCLE | Components include each other endlessly. | directive.component |
DATA_SOURCE_MISSING_NAME | `create-from-data-source` has no file name. | directive.create-from-data-source |
DATA_SOURCE_NOT_FOUND | `create-from-data-source` points to a JSON file that does not exist. | directive.create-from-data-source |
DATA_SOURCE_INVALID_JSON | A data source is not valid JSON. | directive.create-from-data-source |
OPTIONS_INVALID_JSON | The `options` attribute of a directive is not valid JSON. | directive.attributes |
RENDERER_MISSING | A directive has no `renderer` attribute; `basicElement` is used. | api.custom-renderers |
RENDERER_NOT_FOUND | The renderer named in a directive is not registered in `customRenderers`. | api.custom-renderers |
RENDERER_FAILED | A renderer threw an exception. | api.custom-renderers |
DIRECTIVE_NO_REGEX | A custom directive class has no static `regex`. | api.custom-directives |
DIRECTIVE_FAILED | A custom directive threw an exception or returned no HTML. | api.custom-directives |
DIRECTIVE_UNPROCESSED | A directive is still in the page after processing; its content is missing. | behaviour.pipeline |
URL_TO_EMPTY | `url-to` has no value. | directive.url-to |
URL_TO_NOT_FOUND | `url-to` matches no file of the site. | directive.url-to |
URL_TO_AMBIGUOUS | `url-to` matches several files; the closest one is used. | directive.url-to |
PUBLIC_FILE_LIST_RENDERER_NOT_FOUND | `public-file-list` needs a renderer registered in `customRenderers`. | directive.public-file-list |
PUBLIC_FILE_LIST_NOT_FOUND | `public-file-list` points to a folder that does not exist in the output. | directive.public-file-list |
TEMPLATE_NO_DIRECTIVE | A file in pages-to-generate has no `generate-from-files` directive. | directive.generate-from-files |
TEMPLATE_SOURCE_NOT_FOUND | The folder of a `generate-from-files` directive does not exist. | directive.generate-from-files |
MARKDOWN_EMPTY | A Markdown/text file used to generate a page is empty. | content.markdown, directive.generate-from-files |
FRONT_MATTER_INVALID_DATE | A `date` front matter value is not a valid date. | content.front-matter |
I18N_MISSING_KEY | A translation key is used in a page but missing in a language file. | i18n.translation |
I18N_INVALID_FILE | A language file in the i18n folder is not valid JSON. | i18n.translation |
I18N_UNCLOSED_ELEMENT | An element with `data-t` has no closing tag, so it was not translated. | i18n.translation |
I18N_UNTRANSLATED_ATTRIBUTE | A `data-t`/`data-attr-t` attribute is left in the output. | cli.check |
I18N_UNUSED_KEY | A translation key is never used in the sources (it may be used by code). | cli.check |
I18N_INCONSISTENT_KEYS | A translation key exists in some languages but not in others. | cli.check |
POST_PROCESSOR_FAILED | A post processor threw an exception. | config.postProcessors |
HOOK_FAILED | A beforeBuild/afterBuild hook threw an exception. | config.afterBuild, config.beforeBuild |
OUTPUT_LOCKED | Another YASSB process (build, check or watch) is writing the same output folder; nothing was written. | behaviour.output-lock |
BUILD_CRASHED | The build process stopped unexpectedly (watch mode keeps serving the last output). | cli.watch |
MINIFY_FAILED | The HTML minifier could not parse a page; the page was written unminified. | config.htmlMinificationOptions |
STYLES_FAILED | The stylesheet could not be compiled. | assets.styles, config.stylesParser |
SCRIPTS_FAILED | The scripts could not be bundled. | assets.scripts, config.webpackConfig |
LINK_BROKEN | A page links to a local file that is not in the output. | cli.check |
UNUSED_COMPONENT | A component is not used by any page. | cli.check |
UNUSED_DATA_SOURCE | A data source is not used by any page. | cli.check |