grafana/k6 · error

parse isEnabled options of selector

Error message

parse isEnabled options of selector %q: %w

What it means

Thrown synchronously by page.isEnabled(selector, opts) when FrameIsEnabledOptions.Parse fails. The embedded FrameBaseOptions.Parse (internal/js/modules/k6/browser/common/frame_options.go:218-232) coerces strict/timeout and always returns nil, so on stock k6 this wrapper is defensive/unreachable. The selector is echoed in the message for easier location in loops.

Solutions

1. Keep opts to { strict: boolean, timeout: numberMs }
2. Omit opts for defaults
3. Verify schema on customized builds

Example fix

// before
await page.isEnabled('#submit', { timeout: '1s' });

// after
await page.isEnabled('#submit', { timeout: 1000 });

const ALLOWED = new Set(['timeout', 'strict']);
const bad = Object.keys(opts ?? {}).filter(k => !ALLOWED.has(k));
if (bad.length) console.warn(`isEnabled ignores unknown options: ${bad.join(', ')}`);
if (opts?.timeout !== undefined && !Number.isInteger(opts.timeout)) {
  throw new Error('isEnabled timeout must be integer milliseconds');
}
await page.isEnabled(selector, opts);

/** @param {unknown} o */
function isBaseOpts(o) {
  if (o === undefined || o === null) return true;
  if (typeof o !== 'object') return false;
  const t = /** @type {any} */ (o);
  return (t.timeout === undefined || Number.isInteger(t.timeout))
    && (t.strict === undefined || typeof t.strict === 'boolean');
}

try {
  return await page.isEnabled(selector, opts);
} catch (e) {
  if (String(e).includes('isEnabled options')) {
    return await page.isEnabled(selector);
  } throw e;
}

When it happens

Trigger: Not reachable with current stock code; only a stricter custom FrameBaseOptions.Parse could raise it.

Common situations: Custom builds, version drift.

Related errors

• parse isChecked options of selector
• parse isDisabled options of selector
• parse isEditabled options of selector
• parse isEnabled options of selector
• parse isHidden options of selector

AI-assisted analysis of grafana/k6@8d06114777 (2026-09-14). Data as JSON: /api/errors/9aeac5881df37752. Report an issue: GitHub.

Appendix: source

Thrown at internal/js/modules/k6/browser/browser/page_mapping.go:319

				return nil, fmt.Errorf("parse isDisabled options of selector %q: %w", selector, err)
			}
			return promise(vu, func() (any, error) {
				return p.IsDisabled(selector, popts) //nolint:wrapcheck
			}), nil
		},
		"isEditable": func(selector string, opts sobek.Value) (*sobek.Promise, error) {
			popts, err := parseFrameIsEditableOptions(rt, opts, p.MainFrame().Timeout())
			if err != nil {
				return nil, fmt.Errorf("parse isEditabled options of selector %q: %w", selector, err)
			}
			return promise(vu, func() (any, error) {
				return p.IsEditable(selector, popts) //nolint:wrapcheck
			}), nil
		},
		"isEnabled": func(selector string, opts sobek.Value) (*sobek.Promise, error) {
			popts, err := parseFrameIsEnabledOptions(rt, opts, p.MainFrame().Timeout())
			if err != nil {
				return nil, fmt.Errorf("parse isEnabled options of selector %q: %w", selector, err)
			}
			return promise(vu, func() (any, error) {
				return p.IsEnabled(selector, popts) //nolint:wrapcheck
			}), nil
		},
		"isHidden": func(selector string, opts sobek.Value) (*sobek.Promise, error) {
			popts, err := parseFrameIsHiddenOptions(rt, opts)
			if err != nil {
				return nil, fmt.Errorf("parse isHidden options of selector %q: %w", selector, err)
			}
			return promise(vu, func() (any, error) {
				return p.IsHidden(selector, popts) //nolint:wrapcheck
			}), nil
		},
		"isVisible": func(selector string, opts sobek.Value) (*sobek.Promise, error) {
			popts, err := parseFrameIsVisibleOptions(rt, opts)
			if err != nil {
				return nil, fmt.Errorf("parsing isVisible options of selector %q: %w", selector, err)

View on GitHub (pinned to 8d06114777)