Malí globální pomocníci: MAIN, REPO, FUNC, NOW, CLONE, COPY, QUERIFY a PROMISIFY

Total.js 5 · total5@0.0.19 globalsutilitieshelpers Spuštěno s Total.js 5

total5 vytváří několik globálních objektů pro vaše použití a několik helperů, které ušetří řádek kódu. Nic z toho nepotřebuje nastavení.

MAIN, REPO a FUNC jsou prázdné objekty, které framework vytvoří jednou: data aplikace držte v MAIN, jiná data v REPO a vlastní funkce ve FUNC. TEMP je objekt pro dočasná data, který framework čas od času vymění, takže v něm nic nedržte, pokud to budete potřebovat později.
NOW je aktuální datum jako Date. Obnovuje se přibližně jednou za minutu (a některými voláními), takže když potřebujete přesný čas, použijte new Date().
EMPTYARRAY a EMPTYOBJECT jsou zmrazené prázdné hodnoty, které lze vrátit místo vytváření nových: nelze je změnit.
MODS a PLUGINS jsou objekty s načtenými moduly a pluginy podle id. F a Total jsou tentýž objekt, framework, a print je console.log. NOOP je funkce, která nedělá nic.
REQUIRE(name) je require, který navíc řeší balíčky z node_modules aplikace a přijímá názvy jako node:path.
CLONE(value) vytvoří hlubokou kopii: zkopírují se vnořené objekty, pole a data. COPY(from, to) zkopíruje vlastnosti prvního objektu do druhého a vrátí druhý.
QUERIFY([url], object) sestaví query string z objektu: prázdné hodnoty a null se přeskočí a pole se stane hodnotou oddělenou čárkami. S url vrátí url?..., bez ní vrátí ?....
PROMISIFY(fn, a, b, c) zavolá fn(a, b, c, callback) a vrátí promise, který se vyřeší odpovědí callbacku nebo zamítne jeho chybou.

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 });
}