{
  "id": "fn-test-describe",
  "dataComponent": "test",
  "heading": {
    "title": "describe",
    "badges": [
      "Testing",
      "Suite"
    ]
  },
  "synopsis": "Groups a set of test cases under a named suite, then calls the provided callback to define them.",
  "codeBlocks": [
    "extend(\"test\")\\n\\ndescribe(\"1+1\", () => {\\n  it(\"should be 2\", () => {\\n    expect_equal( 1 + 1, 2 )\\n  })\\n})"
  ],
  "notes": [
    "The first argument is a descriptive string name for the test suite.",
    "The second argument is a callback function that contains one or more 'it(...)' calls defining actual tests.",
    "If any assertions fail within that callback, an error is raised and the current test or suite may halt."
  ]
}
