mediawiki-skins-Vector/resources/skins.vector.js/features.js

/** @interface MwApi */

let /** @type {MwApi} */ api;
const debounce = require( /** @type {string} */ ( 'mediawiki.util' ) ).debounce;

/**
 * Saves preference to user preferences and/or cookies.
 *
 * @param {string} feature
 * @param {boolean} enabled
 */
function save( feature, enabled ) {
	if ( mw.user.isAnon() ) {
		switch ( feature ) {
			case 'limited-width':
				if ( enabled ) {
					mw.cookie.set( 'mwclientprefs', null );
				} else {
					mw.cookie.set( 'mwclientprefs', 'vector-feature-limited-width' );
				}
				break;
			default:
				// not a supported anonymous preference
				break;
		}
	} else {
		debounce( function () {
			api = api || new mw.Api();
			api.saveOption( 'vector-' + feature, enabled ? 1 : 0 );
		}, 500 )();
	}
}

/**
 *
 * @param {string} name feature name
 * @param {boolean} [override] option to force enabled or disabled state.
 *
 * @return {boolean} The new feature state (false=disabled, true=enabled).
 * @throws {Error} if unknown feature toggled.
 */
function toggleDocClasses( name, override ) {
	const featureClassEnabled = `vector-feature-${name}-enabled`,
		classList = document.documentElement.classList,
		featureClassDisabled = `vector-feature-${name}-disabled`;

	if ( classList.contains( featureClassDisabled ) || override === true ) {
		classList.remove( featureClassDisabled );
		classList.add( featureClassEnabled );
		return true;
	} else if ( classList.contains( featureClassEnabled ) || override === false ) {
		classList.add( featureClassDisabled );
		classList.remove( featureClassEnabled );
		return false;
	} else {
		throw new Error( `Attempt to toggle unknown feature: ${name}` );
	}
}

/**
 * @param {string} name
 * @throws {Error} if unknown feature toggled.
 */
function toggle( name ) {
	const featureState = toggleDocClasses( name );
	save( name, featureState );
}

/**
 * Checks if the feature is enabled.
 *
 * @param {string} name
 * @return {boolean}
 */
function isEnabled( name ) {
	return document.documentElement.classList.contains( getClass( name, true ) );
}

/**
 * Get name of feature class.
 *
 * @param {string} name
 * @param {boolean} featureEnabled
 * @return {string}
 */
function getClass( name, featureEnabled ) {
	if ( featureEnabled ) {
		return `vector-feature-${name}-enabled`;
	} else {
		return `vector-feature-${name}-disabled`;
	}
}

module.exports = { getClass, isEnabled, toggle, toggleDocClasses };