De små globala hjälparna: MAIN, REPO, FUNC, NOW, CLONE, COPY, QUERIFY och PROMISIFY

Total.js 5 · total5@0.0.19 globalsutilitieshelpers Körd med Total.js 5

total5 skapar några globala objekt för eget bruk och några hjälpare som sparar en kodrad. Inget av detta kräver någon konfiguration.

MAIN, REPO och FUNC är tomma objekt som ramverket skapar en gång: behåll applikationsdata i MAIN, andra data i REPO och dina egna funktioner i FUNC. TEMP är ett objekt för temporära data som ramverket byter ut då och då, så behåll inget i det som du behöver senare.
NOW är aktuellt datum som Date. Det uppdateras ungefär en gång i minuten (och av vissa anrop), så använd new Date() när du behöver den exakta tiden.
EMPTYARRAY och EMPTYOBJECT är frysta tomma värden att returnera i stället för att skapa nya: de kan inte ändras.
MODS och PLUGINS är objekt med de laddade modulerna och pluginsen efter id. F och Total är samma objekt, ramverket, och print är console.log. NOOP är en funktion som inte gör något.
REQUIRE(name) är require som också löser paket från applikationens node_modules och accepterar namn som node:path.
CLONE(value) gör en djup kopia: nästlade objekt, arrayer och datum kopieras. COPY(from, to) kopierar egenskaperna i det första objektet till det andra och returnerar det andra.
QUERIFY([url], object) bygger en query string från ett objekt: tomma värden och null hoppas över och en array blir ett kommaseparerat värde. Med en url returnerar den url?..., utan returnerar den ?....
PROMISIFY(fn, a, b, c) anropar fn(a, b, c, callback) och returnerar ett löfte som löses med callbackens svar eller avvisas med dess fel.

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