fugu-api-data

Project Fugu 🐡 API Data

This repo contains raw data for Project Fugu 🐡 APIs. The data is available in two formats: pattern.js and pattern.mjs.

Data origin

The raw data in this repository comes from a Google spreadsheet that is published as a JSON file. The index.js script fetches this data, prettifies it, and saves it locally in a module and in a no-module variant.

Obtaining fresh data

You can trigger the data fetch process described above by running the start script:

npm start

Data usage

• For the module version:

  import patterns from './patterns.mjs';
  
  console.log(patterns.WebBluetooth);
  /*
  {
    regEx: /navigator\.bluetooth\.requestDevice\s*\(/g,
    where: 'JavaScript',
    supported: (async () => 'bluetooth' in navigator)(),
    featureDetection: `(async () => 'bluetooth' in navigator)()`,
  }
  */

• For the no-module version (for example to use it in a service worker):

  importScripts('patterns.js');
  console.log(patterns.WebBluetooth);
  /*
  {
    regEx: /navigator\.bluetooth\.requestDevice\s*\(/g,
    where: 'JavaScript',
    supported: (async () => 'bluetooth' in navigator)(),
    featureDetection: `(async () => 'bluetooth' in navigator)()`,
  }
  */

Data format

Each API is represented as an object with the following properties:

• regEx: A regular expression that you can use to detect the API of interest in source code when you do static source code analysis.
• where: The resource type where the regular expression needs to match in order to be valid. Either "JavaScript" or "Web App Manifest".
• supported: A function that returns a promise that resolves with true, false, or undefined, dependent on whether the API is supported or not (undefined means no feature detection method exists).
• featureDetection: The source code of the feature detection method, so you can use it in an eval() for example.

Depending projects

This data is used in the following projects:

• The Capabilities report of the HTTP Almanac in the file custom_metrics/fugu-apis.js.
• The Project Fugu 🐡 API Detector browser extension in the files patternsFunc.js and background.js.

License

Apache 2.0.