Watchdog (watchdog)
@ckeditor/ckeditor5-watchdog/src/watchdog
An abstract watchdog class that handles most of the error handling process and the state of the underlying component.
See the Watchdog feature guide to learn the rationale behind it and how to use it.
Filtering
Properties
-
An array of crashes saved as an object with the following properties:
message:String,stack:String,date:Number,filename:String | undefined,lineno:Number | undefined,colno:Number | undefined,
-
state : 'initializing' | 'ready' | 'crashed' | 'crashedPermanently' | 'destroyed'module:watchdog/watchdog~Watchdog#stateSpecifies the state of the item watched by the watchdog. The state can be one of the following values:
initializing– Before the first initialization, and after crashes, before the item is ready.ready– A state when the user can interact with the item.crashed– A state when an error occurs. It quickly changes toinitializingorcrashedPermanentlydepending on how many and how frequent errors have been caught recently.crashedPermanently– A state when the watchdog stops reacting to errors and keeps the item it is watching crashed,destroyed– A state when the item is manually destroyed by the user after callingwatchdog.destroy().
-
-
-
-
The watched item.
-
protected
_minimumNonErrorTimePeriod : Numbermodule:watchdog/watchdog~Watchdog#_minimumNonErrorTimePeriod -
Returns the result of the
Date.now()call. It can be overridden in tests to mock time as some popular approaches likesinon.useFakeTimers()do not work well with error handling. -
A dictionary of event emitter listeners.
Methods
-
constructor( config )module:watchdog/watchdog~Watchdog#constructor -
destroy()module:watchdog/watchdog~Watchdog#destroyDestroys the watchdog and releases the resources.
-
off( eventName, callback )module:watchdog/watchdog~Watchdog#offStops listening to the specified event name by removing the callback from event listeners.
Note that this method differs from the CKEditor 5's default
EventEmitterMixinimplementation.Parameters
eventName : StringThe event name.
callback : functionA callback which will be removed from event listeners.
-
on( eventName, callback )module:watchdog/watchdog~Watchdog#onStarts listening to a specific event name by registering a callback that will be executed whenever an event with a given name fires.
Note that this method differs from the CKEditor 5's default
EventEmitterMixinimplementation.Parameters
eventName : StringThe event name.
callback : functionA callback which will be added to event listeners.
-
setCreator( creator )module:watchdog/watchdog~Watchdog#setCreatorSets the function that is responsible for creating watched items.
Parameters
creator : functionA callback responsible for creating an item. Returns a promise that is resolved when the item is created.
-
setDestructor( destructor )module:watchdog/watchdog~Watchdog#setDestructorSets the function that is responsible for destroying watched items.
Parameters
destructor : functionA callback that takes the item and returns the promise to the destroying process.
-
Fires an event with a given event name and arguments.
Note that this method differs from the CKEditor 5's default
EventEmitterMixinimplementation.Parameters
eventName : StringThe event name.
args : *Event arguments.
-
protected
_isErrorComingFromThisItem( error )module:watchdog/watchdog~Watchdog#_isErrorComingFromThisItemTraverses the error context and the watched item to find out whether the error should be handled by the given item.
Parameters
error : CKEditorError
-
The method responsible for restarting the watched item.
-
Starts error handling by attaching global error handlers.
-
Stops error handling by detaching global error handlers.
-
Checks if the event error comes from the underlying item and restarts the item.
-
Checks if an error comes from the watched item and restarts it. It reacts to
CKEditorErrorerrors only.Parameters
error : ErrorError.
evt : ErrorEvent | PromiseRejectionEventAn error event.
Fires
-
Checks whether an error should be handled by the watchdog.
Parameters
error : ErrorAn error that was caught by the error handling process.
-
Checks if the watchdog should restart the underlying item.
Events
-
error( eventInfo )module:watchdog/watchdog~Watchdog#event:errorFired when a new
CKEditorErrorerror connected to the watchdog instance occurs and the watchdog will react to it.watchdog.on( 'error', ( evt, { error, causesRestart } ) => { console.log( 'An error occurred.' ); } );Parameters
eventInfo : EventInfoAn object containing information about the fired event.
Every day, we work hard to keep our documentation complete. Have you spotted outdated information? Is something missing? Please report it via our issue tracker.