svelte/src/internal/client/dev/assign.js

Cybernetically enhanced web apps

import { STATE_SYMBOL } from '#client/constants';
import { sanitize_location } from '../../../utils.js';
import { untrack } from '../runtime.js';
import * as w from '../warnings.js';

/**
 *
 * @param {any} a
 * @param {any} b
 * @param {string} property
 * @param {string} location
 */
function compare(a, b, property, location) {
	if (a !== b && typeof b === 'object' && STATE_SYMBOL in b) {
		w.assignment_value_stale(property, /** @type {string} */ (sanitize_location(location)));
	}

	return a;
}

/**
 * @param {any} object
 * @param {string} property
 * @param {string} operator
 * @param {any} rhs
 * @param {string} location
 */
export function assign(object, property, operator, rhs, location) {
	return compare(
		operator === '='
			? (object[property] = rhs)
			: operator === '&&='
				? (object[property] &&= rhs())
				: operator === '||='
					? (object[property] ||= rhs())
					: operator === '??='
						? (object[property] ??= rhs())
						: null,
		untrack(() => object[property]),
		property,
		location
	);
}

/**
 * @param {any} object
 * @param {string} property
 * @param {string} operator
 * @param {any} rhs
 * @param {string} location
 */
export async function assign_async(object, property, operator, rhs, location) {
	return compare(
		operator === '='
			? (object[property] = await rhs)
			: operator === '&&='
				? (object[property] &&= await rhs())
				: operator === '||='
					? (object[property] ||= await rhs())
					: operator === '??='
						? (object[property] ??= await rhs())
						: null,
		untrack(() => object[property]),
		property,
		location
	);
}