AGENTS.md

1<!-- Guidance for AI agents working in Selenium JavaScript Bindings -->
2 
3## Code location
4 
5- Library: `javascript/selenium-webdriver/lib/`
6- Tests: `javascript/selenium-webdriver/test/`
7 
8## Common commands
9 
10- Build: `bazel build //javascript/selenium-webdriver/...`
11 
12## Testing
13 
14See `javascript/selenium-webdriver/TESTING.md`
15 
16## Code conventions
17 
18### Logging
19 
20```javascript
21const logging = require('./logging')
22const log_ = logging.getLogger('selenium.webdriver.mymodule')
23 
24log_.warning('actionable: something needs attention')
25log_.info('useful: driver started successfully')
26log_.finer('diagnostic: request details for debugging')
27```
28 
29### Deprecation
30 
31Log a warning directing users to the alternative:
32 
33```javascript
34log_.warning('oldMethod is deprecated, use newMethod instead')
35```
36 
37### Documentation
38 
39Use JSDoc for public APIs:
40 
41```javascript
42/**
43 * Brief description.
44 *
45 * @param {Type} name description
46 * @return {Type} description
47 * @throws {ErrorType} when condition
48 */
49```
50