| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145 |
- /**
- * @license Copyright (c) 2003-2019, CKSource - Frederico Knabben. All rights reserved.
- * For licensing, see LICENSE.md or https://ckeditor.com/legal/ckeditor-oss-license
- */
- /* global console:false */
- import EmitterMixin from '../../src/emittermixin';
- import CKEditorError from '../../src/ckeditorerror';
- import areConnectedThroughProperties from '../../src/areconnectedthroughproperties';
- /**
- * Creates an instance inheriting from {@link utils.EmitterMixin} with one additional method `observe()`.
- * It allows observing changes to attributes in objects being {@link utils.Observable observable}.
- *
- * The `observe()` method accepts:
- *
- * * `{String} observableName` – Identifier for the observable object. E.g. `"Editable"` when
- * you observe one of editor's editables. This name will be displayed on the console.
- * * `{utils.Observable observable} – The object to observe.
- * * `{Array.<String>} filterNames` – Array of property names to be observed.
- *
- * Typical usage:
- *
- * const observer = utils.createObserver();
- * observer.observe( 'Editable', editor.editables.current );
- *
- * // Stop listening (method from the EmitterMixin):
- * observer.stopListening();
- *
- * @returns {Emitter} The observer.
- */
- export function createObserver() {
- const observer = Object.create( EmitterMixin, {
- observe: {
- value: function observe( observableName, observable, filterNames ) {
- observer.listenTo( observable, 'change', ( evt, propertyName, value, oldValue ) => {
- if ( !filterNames || filterNames.includes( propertyName ) ) {
- console.log( `[Change in ${ observableName }] ${ propertyName } = '${ value }' (was '${ oldValue }')` );
- }
- } );
- return observer;
- }
- }
- } );
- return observer;
- }
- /**
- * Checks whether observable properties are properly bound to each other.
- *
- * Syntax given that observable `A` is bound to observables [`B`, `C`, ...]:
- *
- * assertBinding( A,
- * { initial `A` attributes },
- * [
- * [ B, { new `B` attributes } ],
- * [ C, { new `C` attributes } ],
- * ...
- * ],
- * { `A` attributes after [`B`, 'C', ...] changed }
- * );
- */
- export function assertBinding( observable, stateBefore, data, stateAfter ) {
- let key, boundObservable, attrs;
- for ( key in stateBefore ) {
- expect( observable[ key ] ).to.be.equal( stateBefore[ key ] );
- }
- // Change attributes of bound observables.
- for ( [ boundObservable, attrs ] of data ) {
- for ( key in attrs ) {
- if ( !boundObservable.hasOwnProperty( key ) ) {
- boundObservable.set( key, attrs[ key ] );
- } else {
- boundObservable[ key ] = attrs[ key ];
- }
- }
- }
- for ( key in stateAfter ) {
- expect( observable[ key ] ).to.be.equal( stateAfter[ key ] );
- }
- }
- /**
- * An assertion util to test whether the given function throws error that has correct message,
- * data and whether the context of the error and the `editorThatShouldBeFindableFromContext`
- * have common props (So the watchdog will be able to find the correct editor instance and restart it).
- *
- * @param {Function} fn Tested function that should throw a `CKEditorError`.
- * @param {RegExp|String} message Expected message of the error.
- * @param {*} editorThatShouldBeFindableFromContext An editor instance that should be findable from the error context.
- * @param {Object} [data] Error data.
- */
- export function expectToThrowCKEditorError( fn, message, editorThatShouldBeFindableFromContext, data ) {
- let err = null;
- try {
- fn();
- } catch ( _err ) {
- err = _err;
- assertCKEditorError( err, message, editorThatShouldBeFindableFromContext, data );
- }
- expect( err ).to.not.equal( null, 'Function did not throw any error' );
- }
- /**
- * An assertion util to test whether a given error has correct message, data and whether the context of the
- * error and the `editorThatShouldBeFindableFromContext` have common props (So the watchdog will be able to
- * find the correct editor instance and restart it).
- *
- * @param {module:utils/ckeditorerror~CKEditorError} err The tested error.
- * @param {RegExp|String} message Expected message of the error.
- * @param {*} [editorThatShouldBeFindableFromContext] An editor instance that should be findable from the error context.
- * @param {Object} [data] Error data.
- */
- export function assertCKEditorError( err, message, editorThatShouldBeFindableFromContext, data ) {
- if ( typeof message === 'string' ) {
- message = new RegExp( message );
- }
- expect( message ).to.be.a( 'regexp', 'Error message should be a string or a regexp.' );
- expect( err ).to.be.instanceOf( CKEditorError );
- expect( err.message ).to.match( message, 'Error message does not match the provided one.' );
- // TODO: The `editorThatShouldBeFindableFromContext` is optional but should be required in the future.
- if ( editorThatShouldBeFindableFromContext === null ) {
- expect( err.context ).to.equal( null, 'Error context was expected to be `null`' );
- } else if ( editorThatShouldBeFindableFromContext !== undefined ) {
- expect(
- areConnectedThroughProperties( editorThatShouldBeFindableFromContext, err.context ),
- 'Editor cannot be find from the error context'
- );
- }
- if ( data ) {
- expect( err.data ).to.deep.equal( data );
- }
- }
|