CKEditor Ecosystem Documentation
Search
Home/CKEditor 5/API
Class

CKEditorError (utils)

@ckeditor/ckeditor5-utils/src/ckeditorerror

class
See source

The CKEditor error class.

You should throw CKEditorError when:

  • An unexpected situation occurred and the editor (most probably) will not work properly. Such exception will be handled by the watchdog (if it is integrated),

  • If the editor is incorrectly integrated or the editor API is used in the wrong way. This way you will give feedback to the developer as soon as possible. Keep in mind that for common integration issues which should not stop editor initialization (like missing upload adapter, wrong name of a toolbar component) we use console.warn() with attachLinkToDocumentation() to improve developers experience and let them see the working editor as soon as possible.

      /**
   * Error thrown when a plugin cannot be loaded due to JavaScript errors, lack of plugins with a given name, etc.
   *
   * @error plugin-load
   * @param pluginName The name of the plugin that could not be loaded.
   * @param moduleName The name of the module which tried to load this plugin.
   * /
  throw new CKEditorError( 'plugin-load: It was not possible to load the "{$pluginName}" plugin in module "{$moduleName}', {
      pluginName: 'foo',
      moduleName: 'bar'
  } );

Filtering

Properties

  • context : Object | null

    A context of the error by which the Watchdog is able to determine which editor crashed.

    See source

  • data : Object | undefined

    The additional error data passed to the constructor. Undefined if none was passed.

    See source

  • name : String

Methods

  • constructor( message, context, [ data ] )

    Creates an instance of the CKEditorError class.

    See source

    Parameters

    message : String

    The error message in an error-name: Error message. format. During the minification process the "Error message" part will be removed to limit the code size and a link to this error documentation will be added to the message.

    context : Object | null

    A context of the error by which the watchdog is able to determine which editor crashed. It should be an editor instance or a property connected to it. It can be also a null value if the editor should not be restarted in case of the error (e.g. during the editor initialization). The error context should be checked using the areConnectedThroughProperties( editor, context ) utility to check if the object works as the context.

    [ data ] : Object

    Additional data describing the error. A stringified version of this object will be appended to the error message, so the data are quickly visible in the console. The original data object will also be later available under the data property.

  • is()

    Checks if the error is of the CKEditorError type.

    See source

Static methods

  • rethrowUnexpectedError( err, context )

    static

    A utility that ensures the the thrown error is a CKEditorError one. It is useful when combined with the Watchdog feature, which can restart the editor in case of a CKEditorError error.

    See source

    Parameters

    err : Error

    An error.

    context : Object

    An object connected through properties with the editor instance. This context will be used by the watchdog to verify which editor should be restarted.