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 amphtml-validator with all npm packages installed. Try it out:

var amphtmlValidator = require("amphtml-validator")

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

amphtml-validator v1.0.32

Official validator for AMP HTML (www.ampproject.org)

amphtml-validator Node.js Package

This package is published and available at https://www.npmjs.com/package/amphtml-validator.

The source code is available at https://github.com/ampproject/amphtml/tree/master/validator/nodejs.

Command Line Tool

The amphtml-validator command line tool is documented here: https://amp.dev/documentation/guides-and-tutorials/learn/validation-workflow/validate_amp#command-line-tool

Node.js API

This API is new - feedback is especially welcome.

To install, use npm install amphtml-validator in your project directory, or add amphtml-validator as a dependency to your package.json.

You may save the following example into a file, e.g., demo.js.

'use strict';
var amphtmlValidator = require('amphtml-validator');

amphtmlValidator.getInstance().then(function (validator) {
  var result = validator.validateString('<html>Hello, world.</html>');
  (result.status === 'PASS' ? console.log : console.error)(result.status);
  for (var ii = 0; ii < result.errors.length; ii++) {
    var error = result.errors[ii];
    var msg =
      'line ' + error.line + ', col ' + error.col + ': ' + error.message;
    if (error.specUrl !== null) {
      msg += ' (see ' + error.specUrl + ')';
    }
    (error.severity === 'ERROR' ? console.error : console.warn)(msg);
  }
});

Now try running it:

$ node demo.js
FAIL
line 1, col 0: The mandatory attribute '⚡' is missing in tag 'html ⚡ for top-level html'. (see https://amp.dev/documentation/guides-and-tutorials/learn/spec/amphtml#required-markup)
line 1, col 0: The parent tag of tag 'html ⚡ for top-level html' is '$root', but it can only be '!doctype'. (see https://amp.dev/documentation/guides-and-tutorials/learn/spec/amphtml.html#required-markup)
...

As expected, this emits errors because the provided string in the example, <html>Hello, world.</html> is not a valid AMP HTML document.

Release Notes

1.0.32

  • Removal of AMP Actions format as it is deprecated.

1.0.31

  • Fix Node API on Node > 12

1.0.30

  • Remove engine section from pacakge.json to allow any version of nodejs.

1.0.29

  • Reintroduce node v8 support. Supports node v8, v10, v12 and v14.

1.0.28

  • Reintroduce node v10 support and introduce node v14 support.

1.0.27

  • Removed references to amp.validator.categorizeError.

1.0.26

  • Introduce node v12 support and remove node v10 support.

1.0.25

  • Broken release, removed.

1.0.24

  • Introduce node v10 support and remove node 8 support.

1.0.23

  • The amphtml-validator binary now requires the Node.js binary to be called node. On systems where the Node.js binary is called nodejs, consider installing the nodejs-legacy Debian package or better yet, NVM.

1.0.22

  • --html_format=AMP4EMAIL added.

1.0.21

  • --html_format=AMP4ADS is no longer experimental.

1.0.20

  • Better npm post-install for virtual machines, running debian over windows with SMB shared folder.

1.0.19

  • Set correct process exit status for old versions of Node.js (v0.10.25).

1.0.18

  • Small tweaks to this file and package.json.

1.0.17

  • If the amphtml-validator command is already patched up for Windows, leave it alone instead of failing. Relevant if the package has been installed globally and now we're performing a local install on top of it.

1.0.16

  • npm install amphtml-validator (local install) should now work on Windows, for require('amphtml-validator').

1.0.15

  • Added support for installing on Windows. npm install -g amphtml-validator should now just work.

1.0.13

  • Added newInstance method, a simple API that's not async.

1.0.12

  • Added support for --user-agent option.

1.0.11

  • Added support for AMP4ADS (via --html_format command line flag) and argument for validateString function in the API.

1.0.10

Metadata

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