mocha 8.2.1 → 8.3.0

package/CHANGELOG.md

@@ -1,3 +1,28 @@
+# 8.3.0 / 2021-02-11
+
+## :tada: Enhancements
+
+- [#4506](https://github.com/mochajs/mocha/issues/4506): Add error code for test timeout errors ([**@boneskull**](https://github.com/boneskull))
+- [#4112](https://github.com/mochajs/mocha/issues/4112): Add BigInt support to stringify util function ([**@JosejeSinohui**](https://github.com/JosejeSinohui))
+
+## :bug: Fixes
+
+- [#4557](https://github.com/mochajs/mocha/issues/4557): Add file location when SyntaxError happens in ESM ([**@giltayar**](https://github.com/giltayar))
+- [#4521](https://github.com/mochajs/mocha/issues/4521): Fix `require` error when bundling Mocha with Webpack ([**@devhazem**](https://github.com/devhazem))
+
+## :book: Documentation
+
+- [#4507](https://github.com/mochajs/mocha/issues/4507): Add support for typescript-style docstrings ([**@boneskull**](https://github.com/boneskull))
+- [#4503](https://github.com/mochajs/mocha/issues/4503): Add GH Actions workflow status badge ([**@outsideris**](https://github.com/outsideris))
+- [#4494](https://github.com/mochajs/mocha/issues/4494): Add example of generating tests dynamically with a closure ([**@maxwellgerber**](https://github.com/maxwellgerber))
+
+## :nut_and_bolt: Other
+
+- [#4556](https://github.com/mochajs/mocha/issues/4556): Upgrade all dependencies to latest stable ([**@AviVahl**](https://github.com/AviVahl))
+- [#4543](https://github.com/mochajs/mocha/issues/4543): Update dependencies yargs and yargs-parser ([**@juergba**](https://github.com/juergba))
+
+Also thanks to [**@outsideris**](https://github.com/outsideris) and [**@HyunSangHan**](https://github.com/HyunSangHan) for various fixes to our website and documentation.
+
 # 8.2.1 / 2020-11-02
 
 Fixed stuff.

package/LICENSE

@@ -1,6 +1,6 @@
 (The MIT License)
 
-Copyright (c) 2011-2020 OpenJS Foundation and contributors, https://openjsf.org
+Copyright (c) 2011-2021 OpenJS Foundation and contributors, https://openjsf.org
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

package/README.md

@@ -4,10 +4,19 @@
 
 <p align="center">☕️ Simple, flexible, fun JavaScript test framework for Node.js & The Browser ☕️</p>
 
-<p align="center"><a href="http://travis-ci.org/mochajs/mocha"><img src="https://api.travis-ci.org/mochajs/mocha.svg?branch=master" alt="Build Status"></a>  <a href="https://coveralls.io/github/mochajs/mocha"><img src="https://coveralls.io/repos/github/mochajs/mocha/badge.svg" alt="Coverage Status"></a>  <a href="https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmochajs%2Fmocha?ref=badge_shield"><img src="https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmochajs%2Fmocha.svg?type=shield" alt="FOSSA Status"></a>  <a href="https://gitter.im/mochajs/mocha?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge"><img src="https://badges.gitter.im/Join%20Chat.svg" alt="Gitter"></a>  <a href="https://github.com/mochajs/mocha#backers"><img src="https://opencollective.com/mochajs/backers/badge.svg" alt="OpenCollective"></a>  <a href="https://github.com/mochajs/mocha#sponsors"><img src="https://opencollective.com/mochajs/sponsors/badge.svg" alt="OpenCollective"></a>
+<p align="center">
+<a href="https://github.com/mochajs/mocha/actions?query=workflow%3ATests+branch%3Amaster"><img src="https://github.com/mochajs/mocha/workflows/Tests/badge.svg?branch=master" alt="GitHub Actions Build Status"></a>
+<a href="https://coveralls.io/github/mochajs/mocha"><img src="https://coveralls.io/repos/github/mochajs/mocha/badge.svg" alt="Coverage Status"></a>
+<a href="https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmochajs%2Fmocha?ref=badge_shield"><img src="https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmochajs%2Fmocha.svg?type=shield" alt="FOSSA Status"></a>
+<a href="https://gitter.im/mochajs/mocha?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge"><img src="https://badges.gitter.im/Join%20Chat.svg" alt="Gitter"></a>
+<a href="https://github.com/mochajs/mocha#backers"><img src="https://opencollective.com/mochajs/backers/badge.svg" alt="OpenCollective"></a>
+<a href="https://github.com/mochajs/mocha#sponsors"><img src="https://opencollective.com/mochajs/sponsors/badge.svg" alt="OpenCollective"></a>
 </p>
 
-<p align="center"><a href="https://www.npmjs.com/package/mocha"><img src="https://img.shields.io/npm/v/mocha.svg" alt="NPM Version"></a>  <a href="https://github.com/mochajs/mocha"><img src="https://img.shields.io/node/v/mocha.svg" alt="Node Version"></a></p>
+<p align="center">
+<a href="https://www.npmjs.com/package/mocha"><img src="https://img.shields.io/npm/v/mocha.svg" alt="NPM Version"></a>
+<a href="https://github.com/mochajs/mocha"><img src="https://img.shields.io/node/v/mocha.svg" alt="Node Version"></a>
+</p>
 
 <p align="center"><br><img alt="Mocha Browser Support h/t SauceLabs" src="https://saucelabs.com/browser-matrix/mochajs.svg" width="354"></p>
 
@@ -102,6 +111,6 @@ Finally, come [chat with the maintainers](https://gitter.im/mochajs/contributors
 
 ## License
 
-Copyright 2011-2020 OpenJS Foundation and contributors. Licensed [MIT](https://github.com/mochajs/mocha/blob/master/LICENSE).
+Copyright 2011-2021 OpenJS Foundation and contributors. Licensed [MIT](https://github.com/mochajs/mocha/blob/master/LICENSE).
 
 [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmochajs%2Fmocha.svg?type=large)](https://app.fossa.io/projects/git%2Bhttps%3A%2F%2Fgithub.com%2Fmochajs%2Fmocha?ref=badge_large)

package/bin/mocha

@@ -36,8 +36,6 @@ const disableTimeouts = value => {
   if (impliesNoTimeouts(value)) {
     debug('option %s disabled timeouts', value);
     mochaArgs.timeout = 0;
-    delete mochaArgs.timeouts;
-    delete mochaArgs.t;
   }
 };
 
@@ -93,7 +91,6 @@ if (mochaArgs.require && mochaArgs.require.includes('esm')) {
   if (!mochaArgs.require.length) {
     delete mochaArgs.require;
   }
-  delete mochaArgs.r;
 }
 
 if (Object.keys(nodeArgs).length) {

package/lib/browser/growl.js

@@ -125,7 +125,7 @@ function display(runner) {
     cross: '\u274C',
     tick: '\u2705'
   };
-  var logo = require('../../package').notifyLogo;
+  var logo = require('../../package.json').notifyLogo;
   var _message;
   var message;
   var title;

package/lib/cli/collect-files.js

@@ -6,6 +6,7 @@ const debug = require('debug')('mocha:cli:run:helpers');
 const minimatch = require('minimatch');
 const {NO_FILES_MATCH_PATTERN} = require('../errors').constants;
 const lookupFiles = require('./lookup-files');
+const {castArray} = require('../utils');
 
 /**
  * Exports a function that collects test files from CLI parameters.
@@ -21,45 +22,44 @@ const lookupFiles = require('./lookup-files');
  * @returns {string[]} List of files to test
  * @private
  */
-module.exports = ({ignore, extension, file, recursive, sort, spec} = {}) => {
-  let files = [];
+module.exports = ({
+  ignore,
+  extension,
+  file: fileArgs,
+  recursive,
+  sort,
+  spec
+} = {}) => {
   const unmatched = [];
-  spec.forEach(arg => {
-    let newFiles;
+  const specFiles = spec.reduce((specFiles, arg) => {
     try {
-      newFiles = lookupFiles(arg, extension, recursive);
+      const moreSpecFiles = castArray(lookupFiles(arg, extension, recursive))
+        .filter(filename =>
+          ignore.every(pattern => !minimatch(filename, pattern))
+        )
+        .map(filename => path.resolve(filename));
+      return [...specFiles, ...moreSpecFiles];
     } catch (err) {
       if (err.code === NO_FILES_MATCH_PATTERN) {
         unmatched.push({message: err.message, pattern: err.pattern});
-        return;
+        return specFiles;
       }
 
       throw err;
     }
-
-    if (typeof newFiles !== 'undefined') {
-      if (typeof newFiles === 'string') {
-        newFiles = [newFiles];
-      }
-      newFiles = newFiles.filter(fileName =>
-        ignore.every(pattern => !minimatch(fileName, pattern))
-      );
-    }
-
-    files = files.concat(newFiles);
-  });
-
-  const fileArgs = file.map(filepath => path.resolve(filepath));
-  files = files.map(filepath => path.resolve(filepath));
+  }, []);
 
   // ensure we don't sort the stuff from fileArgs; order is important!
   if (sort) {
-    files.sort();
+    specFiles.sort();
   }
 
   // add files given through --file to be ran first
-  files = fileArgs.concat(files);
-  debug('files (in order): ', files);
+  const files = [
+    ...fileArgs.map(filepath => path.resolve(filepath)),
+    ...specFiles
+  ];
+  debug('test files (in order): ', files);
 
   if (!files.length) {
     // give full message details when only 1 file is missing
@@ -70,7 +70,7 @@ module.exports = ({ignore, extension, file, recursive, sort, spec} = {}) => {
     console.error(ansi.red(noneFoundMsg));
     process.exit(1);
   } else {
-    // print messages as an warning
+    // print messages as a warning
     unmatched.forEach(warning => {
       console.warn(ansi.yellow(`Warning: ${warning.message}`));
     });

package/lib/cli/config.js

@@ -38,8 +38,7 @@ const isModuleNotFoundError = err =>
  * returns an object (but could throw)
  */
 const parsers = (exports.parsers = {
-  yaml: filepath =>
-    require('js-yaml').safeLoad(fs.readFileSync(filepath, 'utf8')),
+  yaml: filepath => require('js-yaml').load(fs.readFileSync(filepath, 'utf8')),
   js: filepath => {
     const cwdFilepath = path.resolve(filepath);
     try {

package/lib/cli/options.js

@@ -38,7 +38,8 @@ const {isNodeFlag} = require('./node-flags');
 const YARGS_PARSER_CONFIG = {
   'combine-arrays': true,
   'short-option-groups': false,
-  'dot-notation': false
+  'dot-notation': false,
+  'strip-aliased': true
 };
 
 /**

package/lib/errors.js

@@ -17,6 +17,7 @@ const emitWarning = (msg, type) => {
   if (process.emitWarning) {
     process.emitWarning(msg, type);
   } else {
+    /* istanbul ignore next */
     process.nextTick(function() {
       console.warn(type + ': ' + msg);
     });
@@ -53,88 +54,129 @@ const warn = msg => {
 };
 
 /**
- * When Mocha throw exceptions (or otherwise errors), it attempts to assign a
- * `code` property to the `Error` object, for easier handling.  These are the
- * potential values of `code`.
+ * When Mocha throws exceptions (or rejects `Promise`s), it attempts to assign a `code` property to the `Error` object, for easier handling. These are the potential values of `code`.
+ * @public
+ * @namespace
+ * @memberof module:lib/errors
  */
 var constants = {
   /**
    * An unrecoverable error.
+   * @constant
+   * @default
    */
   FATAL: 'ERR_MOCHA_FATAL',
 
   /**
    * The type of an argument to a function call is invalid
+   * @constant
+   * @default
    */
   INVALID_ARG_TYPE: 'ERR_MOCHA_INVALID_ARG_TYPE',
 
   /**
    * The value of an argument to a function call is invalid
+   * @constant
+   * @default
    */
   INVALID_ARG_VALUE: 'ERR_MOCHA_INVALID_ARG_VALUE',
 
   /**
    * Something was thrown, but it wasn't an `Error`
+   * @constant
+   * @default
    */
   INVALID_EXCEPTION: 'ERR_MOCHA_INVALID_EXCEPTION',
 
   /**
    * An interface (e.g., `Mocha.interfaces`) is unknown or invalid
+   * @constant
+   * @default
    */
   INVALID_INTERFACE: 'ERR_MOCHA_INVALID_INTERFACE',
 
   /**
    * A reporter (.e.g, `Mocha.reporters`) is unknown or invalid
+   * @constant
+   * @default
    */
   INVALID_REPORTER: 'ERR_MOCHA_INVALID_REPORTER',
 
   /**
    * `done()` was called twice in a `Test` or `Hook` callback
+   * @constant
+   * @default
    */
   MULTIPLE_DONE: 'ERR_MOCHA_MULTIPLE_DONE',
 
   /**
    * No files matched the pattern provided by the user
+   * @constant
+   * @default
    */
   NO_FILES_MATCH_PATTERN: 'ERR_MOCHA_NO_FILES_MATCH_PATTERN',
 
   /**
    * Known, but unsupported behavior of some kind
+   * @constant
+   * @default
    */
   UNSUPPORTED: 'ERR_MOCHA_UNSUPPORTED',
 
   /**
    * Invalid state transition occurring in `Mocha` instance
+   * @constant
+   * @default
    */
   INSTANCE_ALREADY_RUNNING: 'ERR_MOCHA_INSTANCE_ALREADY_RUNNING',
 
   /**
    * Invalid state transition occurring in `Mocha` instance
+   * @constant
+   * @default
    */
   INSTANCE_ALREADY_DISPOSED: 'ERR_MOCHA_INSTANCE_ALREADY_DISPOSED',
 
   /**
    * Use of `only()` w/ `--forbid-only` results in this error.
+   * @constant
+   * @default
    */
   FORBIDDEN_EXCLUSIVITY: 'ERR_MOCHA_FORBIDDEN_EXCLUSIVITY',
 
   /**
    * To be thrown when a user-defined plugin implementation (e.g., `mochaHooks`) is invalid
+   * @constant
+   * @default
    */
   INVALID_PLUGIN_IMPLEMENTATION: 'ERR_MOCHA_INVALID_PLUGIN_IMPLEMENTATION',
 
   /**
    * To be thrown when a builtin or third-party plugin definition (the _definition_ of `mochaHooks`) is invalid
+   * @constant
+   * @default
    */
-  INVALID_PLUGIN_DEFINITION: 'ERR_MOCHA_INVALID_PLUGIN_DEFINITION'
+  INVALID_PLUGIN_DEFINITION: 'ERR_MOCHA_INVALID_PLUGIN_DEFINITION',
+
+  /**
+   * When a runnable exceeds its allowed run time.
+   * @constant
+   * @default
+   */
+  TIMEOUT: 'ERR_MOCHA_TIMEOUT'
 };
 
+/**
+ * A set containing all string values of all Mocha error constants, for use by {@link isMochaError}.
+ * @private
+ */
 const MOCHA_ERRORS = new Set(Object.values(constants));
 
 /**
  * Creates an error object to be thrown when no files to be tested could be found using specified pattern.
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @param {string} pattern - User-specified argument value.
  * @returns {Error} instance detailing the error condition
@@ -165,6 +207,7 @@ function createInvalidReporterError(message, reporter) {
  * Creates an error object to be thrown when the interface specified in the options was not found.
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @param {string} ui - User-specified interface value.
  * @returns {Error} instance detailing the error condition
@@ -180,6 +223,7 @@ function createInvalidInterfaceError(message, ui) {
  * Creates an error object to be thrown when a behavior, option, or parameter is unsupported.
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @returns {Error} instance detailing the error condition
  */
@@ -193,6 +237,7 @@ function createUnsupportedError(message) {
  * Creates an error object to be thrown when an argument is missing.
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @param {string} argument - Argument name.
  * @param {string} expected - Expected argument datatype.
@@ -206,6 +251,7 @@ function createMissingArgumentError(message, argument, expected) {
  * Creates an error object to be thrown when an argument did not use the supported type
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @param {string} argument - Argument name.
  * @param {string} expected - Expected argument datatype.
@@ -224,6 +270,7 @@ function createInvalidArgumentTypeError(message, argument, expected) {
  * Creates an error object to be thrown when an argument did not use the supported value
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @param {string} argument - Argument name.
  * @param {string} value - Argument value.
@@ -243,6 +290,7 @@ function createInvalidArgumentValueError(message, argument, value, reason) {
  * Creates an error object to be thrown when an exception was caught, but the `Error` is falsy or undefined.
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @returns {Error} instance detailing the error condition
  */
@@ -258,6 +306,7 @@ function createInvalidExceptionError(message, value) {
  * Creates an error object to be thrown when an unrecoverable error occurs.
  *
  * @public
+ * @static
  * @param {string} message - Error message to be displayed.
  * @returns {Error} instance detailing the error condition
  */
@@ -276,6 +325,7 @@ function createFatalError(message, value) {
  * @param {string} [pluginId] - Name/path of plugin, if any
  * @throws When `pluginType` is not known
  * @public
+ * @static
  * @returns {Error}
  */
 function createInvalidLegacyPluginError(message, pluginType, pluginId) {
@@ -297,6 +347,7 @@ function createInvalidLegacyPluginError(message, pluginType, pluginId) {
  * @param {string} [pluginId] - Name/path of plugin, if any
  * @throws When `pluginType` is not known
  * @public
+ * @static
  * @returns {Error}
  */
 function createInvalidPluginError(...args) {
@@ -309,6 +360,7 @@ function createInvalidPluginError(...args) {
  * @param {string} message The error message to be displayed.
  * @param {boolean} cleanReferencesAfterRun the value of `cleanReferencesAfterRun`
  * @param {Mocha} instance the mocha instance that throw this error
+ * @static
  */
 function createMochaInstanceAlreadyDisposedError(
   message,
@@ -325,6 +377,8 @@ function createMochaInstanceAlreadyDisposedError(
 /**
  * Creates an error object to be thrown when a mocha object's `run` method is called while a test run is in progress.
  * @param {string} message The error message to be displayed.
+ * @static
+ * @public
  */
 function createMochaInstanceAlreadyRunningError(message, instance) {
   var err = new Error(message);
@@ -333,13 +387,14 @@ function createMochaInstanceAlreadyRunningError(message, instance) {
   return err;
 }
 
-/*
+/**
  * Creates an error object to be thrown when done() is called multiple times in a test
  *
  * @public
  * @param {Runnable} runnable - Original runnable
  * @param {Error} [originalErr] - Original error, if any
  * @returns {Error} instance detailing the error condition
+ * @static
  */
 function createMultipleDoneError(runnable, originalErr) {
   var title;
@@ -373,6 +428,7 @@ function createMultipleDoneError(runnable, originalErr) {
 /**
  * Creates an error object to be thrown when `.only()` is used with
  * `--forbid-only`.
+ * @static
  * @public
  * @param {Mocha} mocha - Mocha instance
  * @returns {Error} Error with code {@link constants.FORBIDDEN_EXCLUSIVITY}
@@ -389,6 +445,7 @@ function createForbiddenExclusivityError(mocha) {
 
 /**
  * Creates an error object to be thrown when a plugin definition is invalid
+ * @static
  * @param {string} msg - Error message
  * @param {PluginDefinition} [pluginDef] - Problematic plugin definition
  * @public
@@ -403,6 +460,7 @@ function createInvalidPluginDefinitionError(msg, pluginDef) {
 
 /**
  * Creates an error object to be thrown when a plugin implementation (user code) is invalid
+ * @static
  * @param {string} msg - Error message
  * @param {Object} [opts] - Plugin definition and user-supplied implementation
  * @param {PluginDefinition} [opts.pluginDef] - Plugin Definition
@@ -421,9 +479,26 @@ function createInvalidPluginImplementationError(
   return err;
 }
 
+/**
+ * Creates an error object to be thrown when a runnable exceeds its allowed run time.
+ * @static
+ * @param {string} msg - Error message
+ * @param {number} [timeout] - Timeout in ms
+ * @param {string} [file] - File, if given
+ * @returns {MochaTimeoutError}
+ */
+function createTimeoutError(msg, timeout, file) {
+  const err = new Error(msg);
+  err.code = constants.TIMEOUT;
+  err.timeout = timeout;
+  err.file = file;
+  return err;
+}
+
 /**
  * Returns `true` if an error came out of Mocha.
  * _Can suffer from false negatives, but not false positives._
+ * @static
  * @public
  * @param {*} err - Error, or anything
  * @returns {boolean}
@@ -449,8 +524,18 @@ module.exports = {
   createMochaInstanceAlreadyRunningError,
   createMultipleDoneError,
   createNoFilesMatchPatternError,
+  createTimeoutError,
   createUnsupportedError,
   deprecate,
   isMochaError,
   warn
 };
+
+/**
+ * The error thrown when a Runnable times out
+ * @memberof module:lib/errors
+ * @typedef {Error} MochaTimeoutError
+ * @property {constants.TIMEOUT} code - Error code
+ * @property {number?} timeout Timeout in ms
+ * @property {string?} file Filepath, if given
+ */

package/lib/esm-utils.js

@@ -3,7 +3,29 @@ const url = require('url');
 
 const formattedImport = async file => {
   if (path.isAbsolute(file)) {
-    return import(url.pathToFileURL(file));
+    try {
+      return await import(url.pathToFileURL(file));
+    } catch (err) {
+      // This is a hack created because ESM in Node.js (at least in Node v15.5.1) does not emit
+      // the location of the syntax error in the error thrown.
+      // This is problematic because the user can't see what file has the problem,
+      // so we add the file location to the error.
+      // This `if` should be removed once Node.js fixes the problem.
+      if (
+        err instanceof SyntaxError &&
+        err.message &&
+        err.stack &&
+        !err.stack.includes(file)
+      ) {
+        const newErrorWithFilename = new SyntaxError(err.message);
+        newErrorWithFilename.stack = err.stack.replace(
+          /^SyntaxError/,
+          `SyntaxError[ @${file} ]`
+        );
+        throw newErrorWithFilename;
+      }
+      throw err;
+    }
   }
   return import(file);
 };

package/lib/runnable.js

@@ -5,9 +5,11 @@ var Pending = require('./pending');
 var debug = require('debug')('mocha:runnable');
 var milliseconds = require('ms');
 var utils = require('./utils');
-var errors = require('./errors');
-var createInvalidExceptionError = errors.createInvalidExceptionError;
-var createMultipleDoneError = errors.createMultipleDoneError;
+const {
+  createInvalidExceptionError,
+  createMultipleDoneError,
+  createTimeoutError
+} = require('./errors');
 
 /**
  * Save timer references to avoid Sinon interfering (see GH-237).
@@ -422,14 +424,11 @@ Runnable.prototype.run = function(fn) {
  * @private
  */
 Runnable.prototype._timeoutError = function(ms) {
-  var msg =
-    'Timeout of ' +
-    ms +
-    'ms exceeded. For async tests and hooks, ensure "done()" is called; if returning a Promise, ensure it resolves.';
+  let msg = `Timeout of ${ms}ms exceeded. For async tests and hooks, ensure "done()" is called; if returning a Promise, ensure it resolves.`;
   if (this.file) {
     msg += ' (' + this.file + ')';
   }
-  return new Error(msg);
+  return createTimeoutError(msg, ms, this.file);
 };
 
 var constants = utils.defineConstants(

package/lib/utils.js

@@ -298,6 +298,9 @@ function jsonStringify(object, spaces, depth) {
             ? '-0'
             : val.toString();
         break;
+      case 'bigint':
+        val = val.toString() + 'n';
+        break;
       case 'date':
         var sDate = isNaN(val.getTime()) ? val.toString() : val.toISOString();
         val = '[Date: ' + sDate + ']';