Skip to content

browsers-schema.md

Latest commit

 

History

History
122 lines (88 loc) · 8.54 KB

browsers-schema.md

File metadata and controls

122 lines (88 loc) · 8.54 KB
Raw

The browser JSON schema

This document helps you to understand the structure of the browser (and JavaScript runtime) data in BCD, including the browser type, a display-friendly name, release data and more. Each browser is defined by a unique identifier (for example firefox or chrome_android). Each browser JSON file describes exactly one browser.

Note: while NodeJS and Deno are JavaScript runtimes and not browsers, data for them is placed in browsers, and are included whenever we use the term "browsers".

JSON structure

Below is an example of the browser data:

{
  "browsers": {
    "firefox": {
      "name": "Firefox",
      "type": "desktop",
      "preview_name": "Nightly",
      "pref_url": "about:config",
      "accepts_flags": true,
      "accepts_webextensions": true,
      "releases": {
        "1.5": {
          "release_date": "2005-11-29",
          "release_notes": "https://developer.mozilla.org/Firefox/Releases/1.5",
          "status": "retired",
          "engine": "Gecko",
          "engine_version": "1.8"
        }
      }
    }
  }
}

Properties

name

The name string is a required property which should use the browser brand name and avoid English words if possible, for example "Firefox", "Firefox Android", "Safari", "iOS Safari", etc.

type

The type string is a required property which indicates the platform category the browser runs on. Valid options are "desktop", "mobile", "server" and "xr".

upstream

The upstream string is an optional property which indicates the upstream browser updates are derived from. For example, Firefox Android's upstream browser is Firefox (desktop), and Edge's upstream browser is Chrome. This is used for mirroring data between browsers. Valid options are "chrome", "chrome_android", "firefox", "safari", and "safari_ios".

accepts_flags

A required boolean indicating whether the browser supports flags. If it is set to false, flag data will not be allowed for that browser.

accepts_webextensions

A required boolean indicating whether the browser supports web extensions. A true value will allow this browser to be defined in web extensions support.

pref_url

An optional string containing the URL of the page where feature flags can be changed (for example "about:config" for Firefox or "chrome://flags" for Chrome).

preview_name

An optional string containing the name of the preview browser. For example, "Nightly" for Firefox, "Canary" for Chrome, and "TP" for Safari.

releases

The releases object contains data regarding the browsers' releases, using the version number as the index for each entry within. A release object contains the following properties:

  • A mandatory status property indicating where in the lifetime cycle this release is in. It's an enum accepting these values:

    • retired: This release is no longer supported (EOL). For NodeJS and Deno, every minor/patch release aside from the latest within the major release is considered "retired".
    • current: This release is the official latest release.
    • beta: This release will the next official release.
    • nightly: This release is the current alpha / experimental release (like Firefox Nightly, Chrome Canary).
    • esr: This release is an Extended Support Release or Long Term Support release.
    • planned: This release is planned in the future.

  • An optional release_date property with the YYYY-MM-DD date of when this version was released or will be released.

  • An optional release_notes property which points to release notes. It needs to be a valid URL.

  • An optional engine property which is the name of the browser's engine. Valid values are "Blink", "EdgeHTML", "Gecko", "Presto", "Trident", "WebKit", and "V8". This property is placed on the individual release as a browser may switch to a different engine (for example Microsoft Edge switched to Chrome as its base engine). If engine is specified, engine_version must also be provided.

  • An optional engine_version property indicating the engine version used in this release. Required when engine is specified.

Initial versions

The following table indicates initial versions for browsers in BCD. These are the earliest possible version numbers allowed to be used. When the earliest version is not naturally "1" or "1.0", see the Notes column for an explanation.

Browser Initial version Notes
Bun 1.0.0
Chrome 1
Chrome Android 18 Stable versioning started at 18. No Chrome Android 17 or earlier was ever released.
Deno 1.0
Edge 12 EdgeHTML versioning started at 12, continuing from Internet Explorer 11. After version 18, Edge jumped to version 79, synchronizing with the Chromium versioning scheme.
Firefox 1
Firefox Android 4 Stable versioning started at 4. Earlier non-Android mobile versions are ignored.
IE 1
Node.js 0.10.0 This project selected 0.10.0 as the first release primarily because the 0.10-series releases was the first to have LTS status applied. See issue #6861.
Meta Quest 5.0 The first version documented on the Oculus Developer website.
Opera 2 Stable versioning started at 2. Opera 1 was demoed at a conference, but never publicly released.
Opera Android 10.1 Stable versioning started at 10.1.
Safari 1
iOS Safari 1
Samsung Browser 1.0
WebView Android 1
WebView iOS 1

Exports

This structure is exported for consumers of @mdn/browser-compat-data:

import bcd from '@mdn/browser-compat-data';
bcd.browsers.firefox.releases['1.5'].status; // "retired"
const bcd = require('@mdn/browser-compat-data');
bcd.browsers.firefox.releases['1.5'].status;
// "retired"