| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687 |
- /**
- * @license Copyright (c) 2003-2016, CKSource - Frederico Knabben. All rights reserved.
- * For licensing, see LICENSE.md.
- */
- 'use strict';
- /* global console:false */
- import EmitterMixin from '/ckeditor5/utils/emittermixin.js';
- const utils = {
- /**
- * 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 propery 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.
- */
- 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;
- },
- /**
- * Checkes wether 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 }
- * );
- */
- assertBinding( observable, stateBefore, data, stateAfter ) {
- let key, pair;
- for ( key in stateBefore ) {
- expect( observable[ key ] ).to.be.equal( stateBefore[ key ] );
- }
- // Change attributes of bound observables.
- for ( pair of data ) {
- for ( key in pair[ 1 ] ) {
- pair[ 0 ][ key ] = pair[ 1 ][ key ];
- }
- }
- for ( key in stateAfter ) {
- expect( observable[ key ] ).to.be.equal( stateAfter[ key ] );
- }
- }
- };
- export default utils;
|