Registry / testing / elm-debug-transformer

elm-debug-transformer

library1.2.1jsnpmunverified

Transforms Elm Debug.log output in the browser console into structured, formatted log objects with custom formatters. Current stable version is 1.2.1, released as needed. Key differentiators: works with both Chrome and Firefox custom formatters, exposes a parse() function for programmatic use, and supports simple_mode for reduced verbosity. Unlike basic console logging, it parses Elm's debug output into typed JSON structures. Ships TypeScript declarations, available as ESM/CJS and via CDN.

testing

npm install elm-debug-transformer

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ELM-DEBUG-TRANSFOR

elm-debug-transformer

testingjavascriptv1.2.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

✓ import { register } from 'elm-debug-transformer';

✗ import elmDebugTransformer from 'elm-debug-transformer';

parse

✓ import { parse } from 'elm-debug-transformer';

✗ const { parse } = require('elm-debug-transformer');

Works with both ESM and CJS, but ESM is recommended.

ElmConsoleDebug

✓ window.ElmConsoleDebug.register(); // when using CDN script

✗ import ElmConsoleDebug from 'elm-debug-transformer'; // not available as module export

ElmConsoleDebug is only available via the CDN bundle, not the npm package.

Shows how to import and use register() to enhance Elm Debug.log output, and parse() to manually convert debug strings to structured objects.

import { register, parse } from 'elm-debug-transformer'; // Register the transformer to replace console.log register({ simple_mode: false, debug: false, limit: 10000 }); // Optionally, parse Elm Debug.log output manually const parsed = parse("some tag: [1,2,3]"); console.log(parsed); // { tag: "some tag", value: [1,2,3], type: "List" }

Debug

Known issues

gotchaDebug.log tags must contain only alphabetic characters and spaces. Tags with numbers or special characters will not be parsed and will fall through to original console.log.

fix

Ensure tag strings contain only a-zA-Z and spaces. Example: Debug.log "My Tag" value instead of Debug.log "Tag (1)" value.

affects: >=1.0.0

deprecatedThe default export (ElmDebugger) is deprecated as of v1.1.0. Use named exports instead.

fix

Replace 'import ElmDebugger from "elm-debug-transformer";' with 'import { register, parse } from "elm-debug-transformer";'.

affects: >=1.1.0

breakingIn v1.0.0, parse() was not exposed. Calling parse() before v1.1.0 will throw a TypeError.

fix

Upgrade to v1.1.0 or later to use parse().

affects: <1.1.0

Errors

Common errors & fixes

TypeError: elmDebugTransformer.register is not a function

Using default import when the package only exports named exports.

fix

Change import to: import { register } from 'elm-debug-transformer';

Debug.log output not transformed, same as before

fix

Call register() before any console.log calls. Ensure tag only uses a-zA-Z and spaces.

Upgrade

Version history

1.2.1latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/kraklin/elm-debug-transformer ↗

packageelm-debug-transformer ↗

homepagehttps://github.com/kraklin/elm-debug-transformer#readme ↗