gs-utils-func.js

"use strict";

/* eslint-disable no-empty-function */
function GSUnoop() {}
function GSUnoopFalse() { return false; }
/* eslint-enable */

// .............................................................................
function GSUsetTimeout( fn, sec ) {
	const ms = sec * 1000 | 0;

	return ms > 0
		? setTimeout( fn, ms )
		: ( fn(), null );
}

let _GSUsetInterval_minMs = 0;

function GSUsetIntervalLimit( sec ) {
	return _GSUsetInterval_minMs = sec * 1000 | 0;
}

function GSUsetInterval( fn, sec ) {
	const ms = Math.max( _GSUsetInterval_minMs, sec * 1000 | 0 );

	if ( ms ) {
		return setInterval( fn, ms );
	}

	const obj = Object.seal( { $id: null } );
	const fn2 = () => {
		fn();
		obj.$id = requestAnimationFrame( fn2 );
	};

	fn2();
	return obj;
}

function GSUclearTimeout( id ) {
	clearTimeout( id );
}

function GSUclearInterval( id ) {
	GSUisObj( id )
		? cancelAnimationFrame( id.$id )
		: clearInterval( id );
}

// .............................................................................
function GSUwait( sec ) {
	return new Promise( res => GSUsetTimeout( res, sec ) );
}

// .............................................................................
function GSUdebounce( fn, sec ) {
	let timeoutId;

	return ( ...args ) => {
		GSUclearTimeout( timeoutId );
		return timeoutId = GSUsetTimeout( () => fn( ...args ), sec );
	};
}

function GSUthrottle( fn, sec ) {
	let timeoutId;
	let argsSaved;

	return ( ...args ) => {
		argsSaved = args;
		if ( !timeoutId ) {
			timeoutId = GSUsetTimeout( () => {
				fn( ...argsSaved );
				timeoutId = null;
			}, sec );
		}
		return timeoutId;
	};
}