a3812c6cbd
getCheckNoChangesMode was discovered to be unclear as to the purpose of it. This refactor is a simple renaming to make it much clearer what that method and property does. PR Close #39277
95 lines
3.9 KiB
TypeScript
95 lines
3.9 KiB
TypeScript
/**
|
|
* @license
|
|
* Copyright Google LLC All Rights Reserved.
|
|
*
|
|
* Use of this source code is governed by an MIT-style license that can be
|
|
* found in the LICENSE file at https://angular.io/license
|
|
*/
|
|
|
|
import {devModeEqual} from '../change_detection/change_detection_util';
|
|
import {assertIndexInRange, assertLessThan, assertNotSame} from '../util/assert';
|
|
|
|
import {getExpressionChangedErrorDetails, throwErrorIfNoChangesMode} from './errors';
|
|
import {LView} from './interfaces/view';
|
|
import {isInCheckNoChangesMode} from './state';
|
|
import {NO_CHANGE} from './tokens';
|
|
|
|
|
|
// TODO(misko): consider inlining
|
|
/** Updates binding and returns the value. */
|
|
export function updateBinding(lView: LView, bindingIndex: number, value: any): any {
|
|
return lView[bindingIndex] = value;
|
|
}
|
|
|
|
|
|
/** Gets the current binding value. */
|
|
export function getBinding(lView: LView, bindingIndex: number): any {
|
|
ngDevMode && assertIndexInRange(lView, bindingIndex);
|
|
ngDevMode &&
|
|
assertNotSame(lView[bindingIndex], NO_CHANGE, 'Stored value should never be NO_CHANGE.');
|
|
return lView[bindingIndex];
|
|
}
|
|
|
|
/**
|
|
* Updates binding if changed, then returns whether it was updated.
|
|
*
|
|
* This function also checks the `CheckNoChangesMode` and throws if changes are made.
|
|
* Some changes (Objects/iterables) during `CheckNoChangesMode` are exempt to comply with VE
|
|
* behavior.
|
|
*
|
|
* @param lView current `LView`
|
|
* @param bindingIndex The binding in the `LView` to check
|
|
* @param value New value to check against `lView[bindingIndex]`
|
|
* @returns `true` if the bindings has changed. (Throws if binding has changed during
|
|
* `CheckNoChangesMode`)
|
|
*/
|
|
export function bindingUpdated(lView: LView, bindingIndex: number, value: any): boolean {
|
|
ngDevMode && assertNotSame(value, NO_CHANGE, 'Incoming value should never be NO_CHANGE.');
|
|
ngDevMode &&
|
|
assertLessThan(bindingIndex, lView.length, `Slot should have been initialized to NO_CHANGE`);
|
|
const oldValue = lView[bindingIndex];
|
|
|
|
if (Object.is(oldValue, value)) {
|
|
return false;
|
|
} else {
|
|
if (ngDevMode && isInCheckNoChangesMode()) {
|
|
// View engine didn't report undefined values as changed on the first checkNoChanges pass
|
|
// (before the change detection was run).
|
|
const oldValueToCompare = oldValue !== NO_CHANGE ? oldValue : undefined;
|
|
if (!devModeEqual(oldValueToCompare, value)) {
|
|
const details =
|
|
getExpressionChangedErrorDetails(lView, bindingIndex, oldValueToCompare, value);
|
|
throwErrorIfNoChangesMode(
|
|
oldValue === NO_CHANGE, details.oldValue, details.newValue, details.propName);
|
|
}
|
|
// There was a change, but the `devModeEqual` decided that the change is exempt from an error.
|
|
// For this reason we exit as if no change. The early exit is needed to prevent the changed
|
|
// value to be written into `LView` (If we would write the new value that we would not see it
|
|
// as change on next CD.)
|
|
return false;
|
|
}
|
|
lView[bindingIndex] = value;
|
|
return true;
|
|
}
|
|
}
|
|
|
|
/** Updates 2 bindings if changed, then returns whether either was updated. */
|
|
export function bindingUpdated2(lView: LView, bindingIndex: number, exp1: any, exp2: any): boolean {
|
|
const different = bindingUpdated(lView, bindingIndex, exp1);
|
|
return bindingUpdated(lView, bindingIndex + 1, exp2) || different;
|
|
}
|
|
|
|
/** Updates 3 bindings if changed, then returns whether any was updated. */
|
|
export function bindingUpdated3(
|
|
lView: LView, bindingIndex: number, exp1: any, exp2: any, exp3: any): boolean {
|
|
const different = bindingUpdated2(lView, bindingIndex, exp1, exp2);
|
|
return bindingUpdated(lView, bindingIndex + 2, exp3) || different;
|
|
}
|
|
|
|
/** Updates 4 bindings if changed, then returns whether any was updated. */
|
|
export function bindingUpdated4(
|
|
lView: LView, bindingIndex: number, exp1: any, exp2: any, exp3: any, exp4: any): boolean {
|
|
const different = bindingUpdated2(lView, bindingIndex, exp1, exp2);
|
|
return bindingUpdated2(lView, bindingIndex + 2, exp3, exp4) || different;
|
|
}
|