Ajutorii globali mici: MAIN, REPO, FUNC, NOW, CLONE, COPY, QUERIFY și PROMISIFY

Total.js 5 · total5@0.0.19 globalsutilitieshelpers Executată cu Total.js 5

total5 creează câteva obiecte globale pentru uzul tău și câțiva helperi care economisesc o linie de cod. Nimic din toate acestea nu necesită configurare.

MAIN, REPO și FUNC sunt obiecte goale pe care framework-ul le creează o dată: păstrează datele aplicației în MAIN, alte date în REPO și propriile funcții în FUNC. TEMP este un obiect pentru date temporare pe care framework-ul îl înlocuiește din când în când, deci nu păstra în el nimic de care ai nevoie mai târziu.
NOW este data curentă ca Date. Se reîmprospătează aproximativ o dată pe minut (și prin unele apeluri), deci folosește new Date() când ai nevoie de ora exactă.
EMPTYARRAY și EMPTYOBJECT sunt valori goale înghețate pe care le poți returna în loc să creezi altele noi: nu pot fi modificate.
MODS și PLUGINS sunt obiecte cu modulele și plugin-urile încărcate după id. F și Total sunt același obiect, framework-ul, iar print este console.log. NOOP este o funcție care nu face nimic.
REQUIRE(name) este require, care rezolvă și pachete din node_modules al aplicației și acceptă nume precum node:path.
CLONE(value) face o copie în profunzime: obiectele imbricate, array-urile și datele sunt copiate. COPY(from, to) copiază proprietățile primului obiect în al doilea și îl returnează pe al doilea.
QUERIFY([url], object) construiește un query string dintr-un obiect: valorile goale și null sunt sărite, iar un array devine o valoare separată prin virgule. Cu un url returnează url?..., fără el returnează ?....
PROMISIFY(fn, a, b, c) apelează fn(a, b, c, callback) și returnează o promisiune care se rezolvă cu răspunsul callbackului sau este respinsă cu eroarea lui.

controllers/helpers.js

MAIN.started = 'yes';
REPO.counter = 1;
FUNC.double = n => n * 2;

exports.install = function() {
	ROUTE('GET /helpers/', helpers);
	ROUTE('GET /promisify/', promisify);
};

function helpers($) {

	const source = { a: 1, nested: { b: [1, 2] }, date: new Date(2026, 0, 5) };
	const cloned = CLONE(source);
	const target = { x: 1 };
	const returned = COPY({ y: 2 }, target);

	$.json({
		shared: [MAIN.started, REPO.counter, FUNC.double(4), typeof TEMP],
		now: [NOW instanceof Date, Math.abs(Date.now() - NOW.getTime()) < 120000],
		emptyarray: [EMPTYARRAY.length, Object.isFrozen(EMPTYARRAY)],
		emptyobject: [Object.keys(EMPTYOBJECT).length, Object.isFrozen(EMPTYOBJECT)],
		registries: [typeof MODS, typeof PLUGINS],
		same: [F === Total, typeof print, NOOP() === undefined],
		require: typeof REQUIRE('node:path').join,
		clone: [cloned !== source, cloned.nested !== source.nested, cloned.nested.b !== source.nested.b, cloned.date instanceof Date, cloned.nested.b.join()],
		copy: [returned === target, target.x, target.y],
		querify: QUERIFY('/search/', { q: 'a b', page: 2, empty: '', nothing: null, list: [1, 2] }),
		querify2: QUERIFY({ q: 'x' })
	});
}

async function promisify($) {

	const add = (a, b, callback) => setImmediate(callback, null, a + b);
	const fail = (callback) => setImmediate(callback, 'It failed');

	const sum = await PROMISIFY(add, 2, 3);
	let error = null;

	try {
		await PROMISIFY(fail);
	} catch (e) {
		error = e.message || String(e);
	}

	$.json({ sum: sum, error: error });
}