mathjs/test/node-tests/dist.test.js

// Only use native node.js API's and references to ./lib here, this file is not transpiled!
const assert = require('assert')
const { createSnapshotFromFactories, validateBundle } = require('../../lib/utils/snapshot')
const factoriesAny = require('../../lib/factoriesAny')
const version = require('../../package.json').version

const { expectedInstanceStructure } = createSnapshotFromFactories(factoriesAny)

describe('dist', function () {
  it('should load dist/math.js', function () {
    const math = require('../../dist/math.js')

    assert.strictEqual(math.add(2, 3), 5)
    assert.strictEqual(math.version, version)
  })

  it('should load dist/math.min.js', function () {
    const math = require('../../dist/math.min.js')

    assert.strictEqual(math.add(2, 3), 5)
    assert.strictEqual(math.version, version)
  })

  it('should have all expected functions in dist/main.js', function () {
    // snapshot testing
    const math = require('../../dist/math.js')

    // don't output all warnings "math.foo.bar is move to math.bar, ..."
    const originalWarn = console.warn
    console.warn = (...args) => {
      if (args.join(' ').indexOf('is moved to') === -1) {
        originalWarn.apply(console, args)
      }
    }

    validateBundle(expectedInstanceStructure, math)

    console.warn = originalWarn
  })

  it('should have all expected functions in dist/main.min.js', function () {
    // snapshot testing
    const math = require('../../dist/math.js')

    // don't output all warnings "math.foo.bar is move to math.bar, ..."
    const originalWarn = console.warn
    console.warn = (...args) => {
      if (args.join(' ').indexOf('is moved to') === -1) {
        originalWarn.apply(console, args)
      }
    }

    validateBundle(expectedInstanceStructure, math)

    console.warn = originalWarn
  })

  it('should contain embedded docs for every function', function () {
    const math = require('../../dist/math.js')

    // names to ignore
    const ignore = [
      // functions not supported or relevant for the parser:
      'chain', 'print',
      'compile', 'parse', 'parser', // TODO: add embedded docs for compile, parse, and parser?
      'reviver', // TODO: add embedded docs for reviver?
      'apply', // FIXME: apply is not supported right now because of security concerns
      'eye', 'var', 'eval', 'typeof', // deprecated functions
      'addScalar', 'divideScalar', 'multiplyScalar', 'equalScalar'
    ]

    // test whether all functions are documented
    const missing = []
    for (let prop in math.expression.mathWithTransform) {
      if (math.expression.mathWithTransform.hasOwnProperty(prop)) {
        const obj = math[prop]
        if (math['typeOf'](obj) !== 'Object') {
          try {
            if (ignore.indexOf(prop) === -1) {
              math.help(prop).toString()
            }
          } catch (err) {
            missing.push(prop)
          }
        }
      }
    }

    // test whether there is documentation for non existing functions
    const redundant = []
    const docs = math.docs
    for (let prop in docs) {
      if (docs.hasOwnProperty(prop)) {
        if (math[prop] === undefined) {
          redundant.push(prop)
        }
      }
    }

    if (missing.length > 0 || redundant.length > 0) {
      let message = 'Validation failed: not all functions have embedded documentation. '

      if (missing.length > 0) {
        message += 'Undocumented functions: ' + missing.join(', ') + '. '
      }

      if (redundant.length > 0) {
        message += 'Documentation for non-existing functions: ' + redundant.join(', ') + '. '
      }

      message += 'Embedded documentation for the expression parser is defined in src/expression/embeddedDocs.'

      throw Error(message)
    }
  })
})