ForgeDokumentation
sv

Dokumentation

Globala namn på Total.js 5

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

Total.js 5 visar globala funktioner och objekt för routing, åtgärder, lagring, meddelande och applikationsverktyg.

NamnSlagVad det görRecept
ONfunctionRegistrerar en lyssnare för en applikationshändelse.events
ONCEfunctionSom ON, men lyssnaren körs bara för den första händelsen.events
OFFfunctionTar bort en lyssnare som registrerats med ON.events
EMITfunctionSkickar en händelse med upp till sju argument.events
LOADfunctionLaddar projektets filer (controllers, definitioner...); ramverket anropar den åt dig vid start.load-and-npminstall
LOADCONFIGfunctionTolkar en text i formatet config och tillämpar den på CONF.configuration-file
LOADRESOURCEfunctionLaddar en resurs (en översättningsfil) från en text eller från en URL.localization
PAUSESERVERfunctionPausar eller återupptar servern efter namn: medan den är pausad får begäranden en 503-sida.pause-server
DEBUGbooleantrue i debugläge, false i releaseläge.release-mode-and-debugging
CONFobjectApplikationens konfiguration (filen config och dess standardvärden).configuration-file
DEFobjectRamverkets standardhanterare och inställningar (DEF.onMail, DEF.helpers, DEF.onCSRFcheck...).view-helpers-and-config
FobjectRamverksobjektet. Total är samma objekt.utility-globals
TotalobjectRamverksobjektet (samma som F). Total.run() startar applikationen.release-mode-and-debugging
MAINobjectEtt tomt objekt som ramverket skapar för din applikations data.utility-globals
REPOobjectEtt tomt objekt som ramverket skapar för dina egna data.utility-globals
FUNCobjectEtt tomt objekt som ramverket skapar för dina egna funktioner.utility-globals
TEMPobjectEtt objekt för temporära data; ramverket ersätter det då och då med ett nytt tomt objekt.utility-globals
NOWobjectAktuellt datum, uppdaterat av ramverket en gång i minuten och av vissa anrop som CACHE.utility-globals
EMPTYARRAYobjectEn fryst tom array, för att undvika att skapa nya.utility-globals
EMPTYOBJECTobjectEtt fryst tomt objekt, för att undvika att skapa nya.utility-globals
MODSobjectDe laddade modulerna i mappen modules/, efter id.utility-globals
PLUGINSobjectDe laddade pluginen i mappen plugins/, efter id.utility-globals
NOOPfunctionEn funktion som inte gör något.utility-globals
printfunctionSamma som console.log.utility-globals
REQUIREfunctionSom require, men letar också i applikationens mapp node_modules och accepterar node:-namn.utility-globals

Routning, åtgärder och middleware

NamnSlagVad det görRecept
ROUTEfunctionDeklarerar en route (HTTP, SOCKET, FILE, API eller en reserv som #404).http-methods
NEWACTIONfunctionDeklarerar en åtgärd med dess indata, params, query, utdata och behörigheter.actions-crud
NEWSCHEMAfunctionGrupperar en entitets åtgärder under ett namn.schemas
ACTIONfunctionKör en åtgärd från din egen kod.calling-actions-from-code
EXECfunctionSamma funktion som ACTION.calling-actions-from-code
NEWTRANSFORMfunctionLägger till ett steg i en namngiven kedja av transformeringar.transforms
TRANSFORMfunctionSkickar ett värde genom en kedja av transformeringar.transforms
MIDDLEWAREfunctionRegistrerar en middleware för användning i routes med #name.middleware
NEWMIDDLEWAREfunctionSamma funktion som MIDDLEWARE.middleware
PROXYfunctionVidarebefordrar begäranden under ett URL-prefix till en annan server.proxy
CORSfunctionAnger vilka ursprung som får anropa applikationen från en webbläsare.cors
ErrorBuilderfunctionKlassen som samlar valideringsfel.errors-and-audit
SUCCESSfunctionReturnerar objektet som ramverket skickar vid en lyckad operation ({ success: true, value: value }).errors-and-audit
ERRORfunctionERROR(name) returnerar en callback som loggar felet den får under det namnet; ERROR() returnerar standardcallbacken för fel.errors-and-audit
UNAUTHORIZEDfunctionUNAUTHORIZED($, ...permissions) svarar 401 och returnerar true när användaren inte har någon av behörigheterna; den returnerar false när användaren har en av dem eller är superadministratör.action-user-and-permissions
AUTHfunctionAutentiserar varje begäran: en funktion, eller alternativen för de inbyggda sessionerna.sessions-with-built-in-auth
BLOCKEDfunctionRäknar anropen från en IP-adress och talar om när den nått gränsen.rate-limiting
AUDITfunctionLägger till en granskningspost (användare, meddelande och typ) i en loggfil i logs/.errors-and-audit

Data och cache

NamnSlagVad det görRecept
NOSQLfunctionÖppnar en tabell i den inbyggda NoSQL-databasen.nosql-crud
DATAobjectDatabasoberoende ingång till query buildern.data-api
DBfunctionStartar en fråga med query buildern (DB().find('table').where(...).callback($)); frågan körs av drivrutinen som registrerats med NEWDB.query-builder-db
NEWDBfunctionRegistrerar en databasdrivrutin function(options, callback) för query buildern: standardrutinen, eller en namngiven med NEWDB('name', fn).query-builder-db
CACHEobjectEtt minneslager med utgång.cache
FILECACHEfunctionBeräknar ett resultat en gång och behåller det i en fil en stund.filecache
MEMORIZEfunctionEtt JSON-objekt sparat på disk.memorize
FILESTORAGEfunctionEtt lager för uppladdade filer.filestorage

HTTP-, WebSocket- och meddelandeklienter

NamnSlagVad det görRecept
REQUESTfunctionHTTP-klient på låg nivå.request-and-download
DOWNLOADfunctionSparar svaret från en URL i en fil.request-and-download
RESTBuilderfunctionBuilder för anrop till andra HTTP-API:er.restbuilder
AJAXfunctionAJAX('METHOD /url/', data, callback) gör en begäran med huvudet x-requested-with och returnerar den tolkade kroppen; den returnerar ett promise när det inte finns någon callback.ajax-requests
APIfunctionAnropar en operation i en extern tjänst via dess drivrutin: API('service', 'operation', data).callback($).api-drivers
NEWAPIfunctionRegistrerar drivrutinen function(options, next) för en tjänst till API, med valfri konfiguration.api-drivers
TotalAPIfunctionAnropar en tjänst på Total.js-plattformen via API('TAPI', name, model).remote-service-boundaries
WEBSOCKETCLIENTfunctionEn WebSocket-klient för din applikation.websocket-client
TMSCLIENTfunctionEn klient för Total Messaging Service.tms
PUBLISHfunctionSkickar ett meddelande till de TMS-klienter som prenumererar på det.tms
NEWPUBLISHfunctionDeklarerar ett meddelande som applikationen publicerar.tms
SUBSCRIBEfunctionLägger till en lyssnare för ett meddelande som klienter skickar till applikationen.tms
UNSUBSCRIBEfunctionTar bort lyssnarna för ett TMS-meddelande.tms
NEWSUBSCRIBEfunctionDeklarerar ett meddelande som applikationen tar emot.tms
NEWCALLfunctionDeklarerar en funktion som TMS-klienter kan anropa.tms
OPENCLIENTfunctionAnsluter till OpenPlatform via WebSocket för fjärranrop, händelser och delade anslutningar.openclient-protocol
PROXYCLIENTfunctionAnsluter till en PROXYSERVER via WebSocket och svarar på dess förfrågningar med en lokal server (en port eller ip:port).proxy-tunnel
PROXYSERVERfunctionGör applikationen till en tunnelserver: HTTP-förfrågningarna till en endpoint skickas via en WebSocket-route till en PROXYCLIENT.proxy-tunnel
LDAPfunctionAnsluter till en LDAP-server (port 389 om inte ldap.port säger något annat) och anropar tillbaka med resultatet.ldap-openldap
MAILfunctionSkickar ett e-postmeddelande vars kropp är en vy.send-email
HTMLMAILfunctionSkickar ett e-postmeddelande vars kropp är en HTML-sträng.send-email
LOGMAILfunctionSkickar ett e-postmeddelande vars innehåll är en text utskriven i ett <pre>-block (skicka innehållet som text).logmail
MailobjectKlassen bakom e-postutskicket (SMTP).send-email
AIMODELfunctionStartar en begäran till en språkmodell som registrerats med NEWAIMODEL: AIMODEL('name').user('text').callback($.callback()).ai-models
AIPARSERfunctionSkapar en parser för det strömmade svaret från en AI-leverantör (openai, claude...): write() tar emot bitar och end() returnerar innehållet, resonemanget och verktygsanropen.ai-models
NEWAIMODELfunctionRegistrerar drivrutinen function(ai, done) för en eller flera AI-modeller till AIMODEL, med valfri konfiguration.ai-models
PYPELINEfunctionKör från applikationen en Python-fil i mappen pypelines/ (eller Python-kod inline) och pratar med den via JSON-ramar över en socket.pypeline

Filer, system och workers

NamnSlagVad det görRecept
PATHobjectHjälpfunktioner som bygger sökvägar i projektmapparna (PATH.root(), PATH.public(), PATH.tmp()...).file-download
MERGEfunctionRegistrerar en virtuell, minifierad fil som består av flera filer.minification
TOUCHfunctionRensar de cachade minifierade, temporära och ej funna posterna för en URL, eller för alla.touch-static-cache
CLEANUPfunctionFörstör en ström när den är klar.cleanup-streams
BACKUPfunctionPackar en katalog i en fil.backup-restore-shell
RESTOREfunctionPackar upp en fil som skapats med BACKUP.backup-restore-shell
SHELLfunctionKör ett skalkommando i projektets mapp.backup-restore-shell
NPMINSTALLfunctionInstallerar ett npm-paket i applikationens modulmapp.load-and-npminstall
IMPORTfunctionLaddar ner en JavaScript-fil från en URL och laddar den.import-remote-module
ImageobjectBildbehandling med GraphicsMagick eller ImageMagick.images
NEWTHREADfunctionStartar en worker thread.workers-and-threads
NEWFORKfunctionStartar en barnprocess.workers-and-threads
NEWTHREADPOOLfunctionSkapar en pool av workers som jobb lånar en i taget.thread-pool
CRONfunctionKör en funktion enligt ett schema.cron-jobs
setTimeout2functionsetTimeout med ett id: att anropa den igen med samma id ersätter den tidigare timern.debounce-timers
clearTimeout2functionAvbryter en timer som skapats med setTimeout2.debounce-timers
FlowobjectHanteraren för applikationens FlowStreams: Flow.load(schema), Flow.remove(id), Flow.instances och Flow.test() för en komponent.flowstream, flowstream-component-test
FlowStreamobjectSamma objekt som Flow.flowstream
NEWMACROfunctionKompilerar ett makro från en sträng.macros
NEWCOMPONENTfunctionKompilerar HTML:en för en komponent.native-components
COMPONENTATORfunctionHämtar ett Componentator-paket till public/ som ui-<name>-<hash>.min.js och sparar adressen i F.repo[name].remote-service-boundaries

Verktyg, mallar och lokalisering

NamnSlagVad det görRecept
UobjectRamverkets verktygsobjekt (U.extend(), U.clone()...).utilities
UtilsobjectSamma objekt som U.utilities
UIDfunctionSkapar ett kort unikt id sorterat efter tid.unique-ids-and-hashes
GUIDfunctionSkapar en slumpmässig sträng med angiven längd.unique-ids-and-hashes
HASHfunctionReturnerar en snabb numerisk hash (inte för lösenord).unique-ids-and-hashes
CLONEfunctionGör en djup kopia av ett objekt.utility-globals
COPYfunctionKopierar det första objektets egenskaper till det andra och returnerar det andra.utility-globals
DIFFARRfunctionJämför två arrayer av objekt efter en egenskap och returnerar objekten att lägga till, paren att uppdatera och värdena att ta bort.diffarr-sync-lists
QUERIFYfunctionBygger en URL med frågesträng från ett objekt.utility-globals
PROMISIFYfunctionPROMISIFY(fn, a, b, c) anropar en funktion som tar en callback som sista argument och returnerar ett promise.utility-globals
ENCRYPTfunctionGör om ett värde till en ogenomskinlig token.encrypt-and-decrypt
DECRYPTfunctionLäser ett värde från en token som skapats med ENCRYPT.encrypt-and-decrypt
ENCRYPTREQfunctionKrypterar ett värde tillsammans med en begärans user agent (och dess IP-adress i strikt läge).request-bound-tokens
DECRYPTREQfunctionLäser ett värde som skapats med ENCRYPTREQ; returnerar inget när begäran inte matchar.request-bound-tokens
LOCALIZEfunctionVäljer språk för varje begäran.localization
TRANSLATEfunctionÖversätter @(...)-texterna i en sträng till ett språk.localization
TangularobjectMallmotorn (Tangular.render()).tangular-templates
TaobjectEtt annat namn för Tangular, mallmotorn.template-files
ThelpersobjectHjälpfunktionerna som finns i Tangular-mallar.tangular-templates
TEMPLATEfunctionRenderar en Tangular-mall som är en text, en fil i mappen templates eller en URL, och returnerar ett promise med texten.template-files
controllers/globals.js
exports.install = function() {
	ROUTE('GET /globals/', globals);
};

function globals($) {
	var output = {};
	for (var name of Object.getOwnPropertyNames(globalThis)) {
		var value;
		try {
			value = globalThis[name];
		} catch (e) {
			value = undefined;
		}
		output[name] = typeof(value) === 'function' ? 'function' : value === null ? 'null' : typeof(value);
	}
	$.json(output);
}