1. module bootstrap-lite
   1. function bootstrap-lite.assertJsonEqual (aa, bb)
   2. function bootstrap-lite.assertOrThrow (passed, msg)
   3. function bootstrap-lite.coalesce (...argList)
   4. function bootstrap-lite.identity (val)
   5. function bootstrap-lite.nop ()
   6. function bootstrap-lite.objectAssignDefault (tgt = {}, src = {}, depth = 0)
   7. number bootstrap-lite.timeExit
   8. object bootstrap-lite.bootstrap
   9. object bootstrap-lite.local
   10. string bootstrap-lite.__dirname

module bootstrap-lite

function bootstrap-lite.assertJsonEqual (aa, bb)

• description and source-code

  assertJsonEqual = function (aa, bb) {
  /*
   * this function will assert JSON.stringify(<aa>) === JSON.stringify(<bb>)
   */
      let objectDeepCopyWithKeysSorted;
      objectDeepCopyWithKeysSorted = function (obj) {
      /*
       * this function will recursively deep-copy <obj> with keys sorted
       */
          let sorted;
          if (typeof obj !== "object" || !obj) {
              return obj;
          }
          // recursively deep-copy list with child-keys sorted
          if (Array.isArray(obj)) {
              return obj.map(objectDeepCopyWithKeysSorted);
          }
          // recursively deep-copy obj with keys sorted
          sorted = {};
          Object.keys(obj).sort().forEach(function (key) {
              sorted[key] = objectDeepCopyWithKeysSorted(obj[key]);
          });
          return sorted;
      };
      aa = JSON.stringify(objectDeepCopyWithKeysSorted(aa));
      bb = JSON.stringify(objectDeepCopyWithKeysSorted(bb));
      if (aa !== bb) {
          throw new Error(JSON.stringify(aa) + " !== " + JSON.stringify(bb));
      }
  }

• example use

  n/a

function bootstrap-lite.assertOrThrow (passed, msg)

• description and source-code

  assertOrThrow = function (passed, msg) {
  /*
   * this function will throw <msg> if <passed> is falsy
   */
      if (passed) {
          return;
      }
      throw (
          (
              msg
              && typeof msg.message === "string"
              && typeof msg.stack === "string"
          )
          // if msg is err, then leave as is
          ? msg
          : new Error(
              typeof msg === "string"
              // if msg is string, then leave as is
              ? msg
              // else JSON.stringify(msg)
              : JSON.stringify(msg, undefined, 4)
          )
      );
  }

• example use

  n/a

function bootstrap-lite.coalesce (...argList)

• description and source-code

  coalesce = function (...argList) {
  /*
   * this function will coalesce null, undefined, or "" in <argList>
   */
      let arg;
      let ii;
      ii = 0;
      while (ii < argList.length) {
          arg = argList[ii];
          if (arg !== undefined && arg !== null && arg !== "") {
              return arg;
          }
          ii += 1;
      }
      return arg;
  }

• example use

  n/a

function bootstrap-lite.identity (val)

• description and source-code

  identity = function (val) {
  /*
   * this function will return <val>
   */
      return val;
  }

• example use

  ...
  }
  // init lib main
  local.bootstrap = local;
  
  
  /* validateLineSortedReset */
  // run browser js-env code - init-function
  local.identity(function () {
  if (!local.isBrowser) {
      return;
  }
  /* jslint ignore:start */
  let define;
  let exports;
  let module;
  ...

function bootstrap-lite.nop ()

• description and source-code

  nop = function () {
  /*
   * this function will do nothing
   */
      return;
  }

• example use

  n/a

function bootstrap-lite.objectAssignDefault (tgt = {}, src = {}, depth = 0)

• description and source-code

  objectAssignDefault = function (tgt = {}, src = {}, depth = 0) {
  /*
   * this function will if items from <tgt> are null, undefined, or "",
   * then overwrite them with items from <src>
   */
      let recurse;
      recurse = function (tgt, src, depth) {
          Object.entries(src).forEach(function ([
              key, bb
          ]) {
              let aa;
              aa = tgt[key];
              if (aa === undefined || aa === null || aa === "") {
                  tgt[key] = bb;
                  return;
              }
              if (
                  depth !== 0
                  && typeof aa === "object" && aa && !Array.isArray(aa)
                  && typeof bb === "object" && bb && !Array.isArray(bb)
              ) {
                  recurse(aa, bb, depth - 1);
              }
          });
      };
      recurse(tgt, src, depth | 0);
      return tgt;
  }

• example use

  n/a