Troubleshooting

Common failures and what to check first.

natl: command not found

npm install -g @natl/cli @natl/adapter-playwright
npm prefix -g
natl --version

Browser / Chromium errors

npx playwright install chromium
npx playwright install --with-deps chromium

FAIL … assert / element not found

• Is the selector still right?
• Prefer stable #id
• Check artifacts/

YAML indentation

- fill: "#email"
  with: $user

HTTP examples hang

node stubs/echo-server.mjs
natl run http_only.yaml

Wrong engine

natl engines
npm install -g @natl/adapter-playwright

Still stuck? GitHub issues.