https://github.com/whatwg/webidl

Web IDL Standard
https://github.com/whatwg/webidl

idl javascript standard webidl webidl-standard whatwg

Last synced: about 2 months ago
JSON representation

Web IDL Standard

• Host: GitHub
• URL: https://github.com/whatwg/webidl
• Owner: whatwg
• License: other
• Created: 2013-11-05T04:17:09.000Z (almost 11 years ago)
• Default Branch: main
• Last Pushed: 2024-08-02T05:37:26.000Z (about 2 months ago)
• Last Synced: 2024-08-02T06:42:41.988Z (about 2 months ago)
• Topics: idl, javascript, standard, webidl, webidl-standard, whatwg
• Language: HTML
• Homepage: https://webidl.spec.whatwg.org/
• Size: 19.9 MB
• Stars: 390
• Watchers: 69
• Forks: 160
• Open Issues: 239
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
This repository hosts the [Web IDL Standard](https://webidl.spec.whatwg.org/).

## Code of conduct

We are committed to providing a friendly, safe, and welcoming environment for all. Please read and

respect the [WHATWG Code of Conduct](https://whatwg.org/code-of-conduct).

## Contributing

Good first issues are labeled as a [short good first issue](https://github.com/heycam/webidl/issues?q=is%3Aopen+label%3A%22%E2%8C%9B+duration%3Ashort%22+label%3A%22good+first+issue%22).

IDL generally follows the [WHATWG Contributor Guidelines](https://github.com/whatwg/meta/blob/main/CONTRIBUTING.md) and [WHATWG Committer Guidelines](https://github.com/whatwg/meta/blob/main/COMMITTING.md), except as otherwise noted.

## Markup

The specification is written in [Bikeshed](https://github.com/tabatkins/bikeshed), plus the [Ecmarkup tags](https://tc39.es/ecmarkup/) ``, ``, and ``.

## Building "locally"

For quick local iteration, run `make`. To verify your changes locally, run `npm install` and

`make deploy`. See more in the

[WHATWG Contributor Guidelines](https://github.com/whatwg/meta/blob/main/CONTRIBUTING.md#building).

## Filing issues elsewhere

### Breaking changes should be filed against:

*   Rendering engines

    *   [Gecko](https://bugzilla.mozilla.org/enter_bug.cgi?product=Core&component=DOM&[email protected])

    *   [WebKit](https://bugs.webkit.org/enter_bug.cgi?product=WebKit&component=Bindings&short_desc=[WebIDL]%20)

    *   [Chromium](https://bugs.chromium.org/p/chromium/issues/entry?template=Defect%20report%20from%20developer&components=Blink%3EBindings&summary=[WebIDL]%20&comment&labels=Via-WebIDLRepo)

*   [web-platform-tests](https://github.com/web-platform-tests/wpt/issues/new?title=%5BWebIDL%5D%20)

*   [idlharness.js](https://github.com/web-platform-tests/wpt/issues/new?title=%5Bidlharness%5D%20) (used by testharness.js to run IDL tests)

*   [Reffy](https://github.com/tidoust/reffy) (scrapes IDL from specs for [reffy-reports](https://github.com/tidoust/reffy-reports) and web-platform-tests)

### Syntax changes should be filed against the following parsers:

*   [widlparser](https://github.com/plinss/widlparser/issues/new) (used by Bikeshed)

*   [WebIDL parser](https://github.com/w3c/webidl2.js/issues/new/choose) (used by idlharness.js)

*   [TypeScript and JavaScript lib generator](https://github.com/Microsoft/TSJS-lib-generator/)