Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 1,000,000+ packages pre-installed, including @ampproject/toolbox-validator-rules with all npm packages installed. Try it out:

var toolboxValidatorRules = require("@ampproject/toolbox-validator-rules")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

@ampproject/toolbox-validator-rules v2.5.4

A library that helps query AMP Validator rules

AMP-Toolbox Validator Rules

npm version

Queries published AMP Validator rules and extracts information about required markup and attributes for all AMP formats.

Usage

Install via:

$ npm install @ampproject/toolbox-validator-rules

Including the Module

ES Module (Browser)

import validatorRules from '@ampproject/toolbox-validator-rules';

CommonJs (Node)

const validatorRules = require('@ampproject/toolbox-validator-rules');

Using the module

  // Loads the validator rules remotely with default options
  const rules = await validatorRules.fetch();


  // The raw unprocessed rules
  console.log(rules.raw);

  // All tags, combined with their respective attribute lists
  console.log(rules.tags);

  // All extensions
  console.log(rules.extensions);

  // Get all tag names used in AMP for Email
  // The supported formats are AMP, AMP4EMAIL, AMP4ADS and ACTIONS
  const tags = rules.getTagsForFormat('AMP4EMAIL');

  // Display their names
  console.log(tags.map(tag => tag.tagName));

  // Get information about an extension
  const ext = rules.getExtension('AMP4EMAIL', 'amp-carousel');

  // Display supported versions
  console.log(ext.versions);

Format of rules

The rules used closely follow the proto definitions from validator.proto.

Specifically:

  • The raw property is unprocessed ValidatorRules, the same format used by https://cdn.ampproject.org/v0/validator.json
  • The result of getTagsForFormat and the tags property is a list of TagSpec
  • The result of getExtension is ExtensionSpec with the htmlFormat field from TagSpec
  • The extensions property a list of ExtensionSpec with the htmlFormat field from TagSpec
  • The errors property combines ErrorFormat and ErrorSpecificity

Options

fetch optionally accepts an options object allowing you to customize its behaviour.

The following options are supported:

  • noCache: true to always fetch latest rules (by default, subsequent calls to fetch reuse the same result).
  • rules: object to use locally specified rules instead of fetching them from the AMP CDN.
  • url: override the URL where validator rules are fetched from.
  • source: one of 'local' (load rules from local file named "validator.json"), 'remote' (fetch rules from CDN) or 'auto' which is the default (tries looking for the local file first, then tries to fetch from CDN).

Example:

validatorRules.fetch({
  noCache: true,
  source: 'remote'
});
RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free