ractive/src/Ractive/prototype/shared/makeArrayMethod.js

Next-generation DOM manipulation

import isArray from 'utils/isArray';
import runloop from 'global/runloop';
import getSpliceEquivalent from 'shared/getSpliceEquivalent';
import summariseSpliceOperation from 'shared/summariseSpliceOperation';

var arrayProto = Array.prototype;

export default function ( methodName ) {
	return function ( keypath, ...args ) {
		var array, spliceEquivalent, spliceSummary, promise;

		array = this.get( keypath );

		if ( !isArray( array ) ) {
			throw new Error( 'Called ractive.' + methodName + '(\'' + keypath + '\'), but \'' + keypath + '\' does not refer to an array' );
		}

		spliceEquivalent = getSpliceEquivalent( array, methodName, args );
		spliceSummary = summariseSpliceOperation( array, spliceEquivalent );

		arrayProto[ methodName ].apply( array, args );

		promise = runloop.start( this, true );
		if ( spliceSummary ) {
			this.viewmodel.splice( keypath, spliceSummary );
		} else {
			this.viewmodel.mark( keypath );
		}
		runloop.end();

		return promise;
	};
}