{
  "slug": "cypress-expose-supports-suite-and-test-level-config-overrides-16f90c36d710",
  "title": "Cypress.expose() supports suite- and test-level config overrides",
  "tools": [
    "cypress"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-06-09T00:00:00.000Z",
  "announced_at": "2026-06-09T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When a suite or test needs different public values, pass them in its test config as `{ expose: { key: value } }`; suite and test overrides merge, with test values taking precedence.",
    "examples": [
      "describe('checkout', { expose: { flow: 'guest' } }, () => {\n  it('uses suite and test values', { expose: { step: 'payment' } }, () => {\n    expect(Cypress.expose('flow')).to.eq('guest')\n    expect(Cypress.expose('step')).to.eq('payment')\n  })\n})"
    ],
    "gotchas": [
      "Version: 15.17.0",
      "suite/test config `expose` object: Object of public configuration values to override for the suite or test.",
      "`expose` object keys and values: Each key names an exposed variable and its value is the value to set; suite and test objects merge, and duplicate keys use the test-level value. No documented sub-key restriction.",
      "Prerequisite: Use only for public, non-sensitive values accessible in the browser context."
    ]
  },
  "why_it_matters": "Set different Cypress.expose() values for individual suites or tests.",
  "sources": [
    "https://docs.cypress.io/app/references/changelog#15-17-0",
    "https://docs.cypress.io/api/cypress-api/expose"
  ],
  "rank": 0.9604,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave2b-20261017",
    "verdict_id": "wave2b-20261017:wave2b-20261017-8b8c6b34855db5f8-1:gate",
    "evidence_hash": "9ab246c54ab030c92bffb68e41f50ad0957c06dc10d2a5c252351d7627f4e92c"
  },
  "review": {
    "draft_hash": "dc2d864db9803a5552d0a2c80037f716b7be36f67832d077677fcf7f1de7d441",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave2b-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.96 >= 0.9; 2 needed) and Jev gave 0.66 (>= 0.6 needed)."
  }
}