jasmine/AGENTS.md

Jasmine Core Development Notes

Architecture

• This is the main jasmine-core repository, a JavaScript BDD testing framework
• Directory structure:
  • src/ - source code
    • src/core/ - environment-agnostic core functionality
    • src/html/ - browser-specific code
    • src/boot/ - boot files for browser setup
  • spec/ - tests, mirrors the src directory structure
  • lib/ - compiled distribution files (built, not checked in modified)

Key Development Commands

• npm install - install dependencies
• npm test - run all tests in Node.js + lint + prettier check
• npm run test:parallel - run tests in parallel
• npm run build - build distribution to /lib
• npm run cleanup - auto-fix prettier errors
• npm run serve - serve tests for browser testing at http://localhost:8888
• JASMINE_BROWSER=<name> npm run ci - run browser tests via Selenium

Before submitting PR

1. Run tests in Node.js AND browsers: npm test and npm run serve
2. Fix any eslint/prettier errors: npm run cleanup
3. Build lib/ with npm run build and re-test
4. Revert changes to built files in lib/ - maintainers will rebuild when merging

Testing Conventions

• Jasmine self-tests: lib/jasmine-core.js provides jasmine (runner), src/ provides jasmineUnderTest (code under test)
• Always use jasmineUnderTest for objects/functions being tested

Coding Conventions

• Single quotes, semicolons required
• Curly braces required for all control statements
• ECMA 2022 syntax, commonjs modules
• Core code must stay environment-agnostic:
  • Keep browser-specific code in src/html/
  • Degrade gracefully when environment-specific features aren't available

Supported Environments

• Node: 20, 22, 24
• Browsers: Safari 26+, Chrome/Firefox/Edge (evergreen)