Source: errors.js

  1. /**
  2.  * Append the old error message to the new one and keep its stack trace.
  3.  * Example:
  4.  *     throw wrap(e, HighLevelError, "This error is more specific");
  5.  */
  6. function wrap(
  7.     oldError,
  8.     newErrorType,
  9.     ...args
  10. ) {
  11.     const newError = new newErrorType(...args);
  12.     let appendMsg;
  13.     if (oldError instanceof Error) {
  14.         appendMsg = oldError.message;
  15.         newError.stack = oldError.stack;
  16.     }
  17.     else {
  18.         appendMsg = oldError.toString();
  19.     }
  20.     newError.message += ":\n" + appendMsg;
  21.     return newError;
  22. }
  24. /**
  25.  * Ensures `args` contain an error message defaulting to `defaultMsg`.
  26.  *
  27.  * Modifies `args`.
  28.  * @param {Array<str>} args The arguments to an Error object constructor.
  29.  * @param {str} defaultMsg The error message to default to if there is none given.
  30.  */
  31. function defaultMessage(args, defaultMsg) {
  32.     args[0] = args[0] || defaultMsg;
  33. }
  35. /**
  36.  * Base Error for when the bride can not handle the event.
  37.  */
  38. class EventNotHandledError extends Error {
  39.     constructor(...args) {
  40.         defaultMessage(args, "The event could not be handled by the bridge");
  41.         super(...args);
  42.         this.name = "EventNotHandledError";
  43.         this.reason = "m.event_not_handled";
  44.     }
  45. }
  47. /**
  48.  * The bridge decides that the event is too old to be sent.
  49.  */
  50. class EventTooOldError extends EventNotHandledError {
  51.     constructor(...args) {
  52.         defaultMessage(args, "The event was too old to be handled by the bridge");
  53.         super(...args);
  54.         this.name = "EventTooOldError";
  55.         this.reason = "m.event_too_old";
  56.     }
  57. }
  59. /**
  60.  * An unexpected internal error occured while the bridge handled the event.
  61.  */
  62. class BridgeInternalError extends EventNotHandledError {
  63.     constructor(...args) {
  64.         defaultMessage(args, "The bridge experienced an internal error");
  65.         super(...args);
  66.         this.name = "EventTooOldError";
  67.         this.reason = "m.internal_error";
  68.     }
  69. }
  71. /**
  72.  * The foreign network errored and the event couldn't be delivered.
  73.  */
  74. class ForeignNetworkError extends EventNotHandledError {
  75.     constructor(...args) {
  76.         defaultMessage(args, "The foreign network experienced an error");
  77.         super(...args);
  78.         this.name = "ForeignNetworkError";
  79.         this.reason = "m.foreign_network_error";
  80.     }
  81. }
  83. /**
  84.  * The event is not understood by the bridge.
  85.  */
  86. class EventUnknownError extends EventNotHandledError {
  87.     constructor(...args) {
  88.         defaultMessage(args, "The event is not known to the bridge");
  89.         super(...args);
  90.         this.name = "EventUnknownError";
  91.         this.reason = "m.event_unknown";
  92.     }
  93. }
  95. module.exports = {
  96.     wrap,
  97.     EventNotHandledError,
  98.     EventTooOldError,
  99.     BridgeInternalError,
  100.     ForeignNetworkError,
  101.     EventUnknownError,
  102. }