Allow preview browsers in the data structure

browsers/chrome.json

@@ -2,6 +2,7 @@
   "browsers": {
     "chrome": {
       "name": "Chrome",
+      "preview_name": "Canary",
       "pref_url": "chrome://flags",
       "releases": {
         "1": {

browsers/firefox.json

@@ -2,6 +2,7 @@
   "browsers": {
     "firefox": {
       "name": "Firefox",
+      "preview_name": "Nightly",
       "pref_url": "about:config",
       "releases": {
         "1": {

browsers/safari.json

@@ -2,6 +2,7 @@
   "browsers": {
     "safari": {
       "name": "Safari",
+      "preview_name": "TP",
       "releases": {
         "1": {
           "release_date": "2003-06-23",

schemas/browsers-schema.md

@@ -17,6 +17,7 @@ The file `firefox.json` is structured like this:
   "browsers": {
     "firefox": {
       "name": "Firefox",
+      "preview_name": "Nightly",
       "pref_url": "about:config",
       "releases": {
         "1.5": {
@@ -40,6 +41,10 @@ Underneath, there is a `releases` object which will hold the various releases of
 
 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.
 
+### `preview_name`
+
+An optional string containing the name of the preview browser. For example, this is "Nightly" for Firefox, "Canary" for Chrome, and "TP" for Safari.
+
 ### `pref_url`
 
 An optional string containing the URL of the page where feature flags can be changed (e.g. `"about:config"` for Firefox or `"chrome://flags"` for Chrome).

schemas/browsers.schema.json

@@ -30,6 +30,10 @@
           "type": "string",
           "description": "Browser name, avoid using unnecessary English (e.g. prefer 'Chrome Android' over 'Chrome for Android')."
         },
+        "preview_name": {
+          "type": "string",
+          "description": "Preview name, avoid long form names (use 'Nightly' instead of 'Firefox Nightly')."
+        },
         "pref_url": {
           "type": "string",
           "description": "URL of the page where feature flags can be changed (e.g. 'about:config' or 'chrome://flags')."

test/linter/test-consistency.js

@@ -322,6 +322,15 @@ class ConsistencyChecker {
       if (b_version_added.startsWith('≤')) {
         return false;
       }
+      if (a_version_added === 'preview' && b_version_added === 'preview') {
+        return false;
+      }
+      if (b_version_added === 'preview') {
+        return true;
+      }
+      if (a_version_added === 'preview') {
+        return false;
+      }
       return compareVersions.compare(
         a_version_added.replace('≤', ''),
         b_version_added,

test/linter/test-versions.js

@@ -33,6 +33,9 @@ for (const browser of Object.keys(browsers)) {
   if (VERSION_RANGE_BROWSERS[browser]) {
     validBrowserVersions[browser].push(...VERSION_RANGE_BROWSERS[browser]);
   }
+  if (browsers[browser].preview_name) {
+    validBrowserVersions[browser].push('preview');
+  }
 }
 
 /**
@@ -54,6 +57,16 @@ function isValidVersion(browserIdentifier, version) {
 function removedAfterAdded(statement) {
   const { version_added, version_removed } = statement;
 
+  if (version_added === 'preview' && version_removed === 'preview') {
+    return false;
+  }
+  if (version_added === 'preview' && version_removed !== 'preview') {
+    return false;
+  }
+  if (version_added !== 'preview' && version_removed === 'preview') {
+    return true;
+  }
+
   if (
     !(
       compareVersions.validate(version_added.replace('≤', '')) &&

types.d.ts

@@ -45,6 +45,12 @@ export interface BrowserStatement {
    */
   name: string;
 
+  /**
+   * The preview browser's name, for example:
+   * `"Nightly"`, `"Canary"`, `"TP"`, etc.
+   */
+  preview_name: string;
+
   /**
    * The known versions of this browser.
    */