ForgeDocumentatie
nl

Documentatie

Wereldnaam van Total.js 5

Total.js 5 · total5@0.0.19 referenceglobals Uitgevoerd met Total.js 5

Total.js 5 toont wereldwijde functies en objecten voor routing, acties, opslag, boodschappen en applicatie-instrumenten.

NaamSoortWat het doetRecept
ONfunctionRegistreert een listener voor een applicatie-event.events
ONCEfunctionZoals ON, maar de listener draait alleen voor het eerste event.events
OFFfunctionVerwijdert een met ON geregistreerde listener.events
EMITfunctionZendt een event uit met maximaal zeven argumenten.events
LOADfunctionLaadt de bestanden van het project (controllers, definities...); het framework roept het bij het starten voor je aan.load-and-npminstall
LOADCONFIGfunctionParsed een tekst in het config-formaat en past die toe op CONF.configuration-file
LOADRESOURCEfunctionLaadt een resource (een vertaalbestand) uit een tekst of van een URL.localization
PAUSESERVERfunctionPauzeert of hervat de server op naam: tijdens de pauze krijgen verzoeken een 503-pagina.pause-server
DEBUGbooleantrue in debugmodus, false in releasemodus.release-mode-and-debugging
CONFobjectDe configuratie van de applicatie (het bestand config en zijn standaardwaarden).configuration-file
DEFobjectStandaardhandlers en -instellingen van het framework (DEF.onMail, DEF.helpers, DEF.onCSRFcheck...).view-helpers-and-config
FobjectHet frameworkobject. Total is hetzelfde object.utility-globals
TotalobjectHet frameworkobject (hetzelfde als F). Total.run() start de applicatie.release-mode-and-debugging
MAINobjectEen leeg object dat het framework maakt voor de gegevens van je applicatie.utility-globals
REPOobjectEen leeg object dat het framework maakt voor je eigen gegevens.utility-globals
FUNCobjectEen leeg object dat het framework maakt voor je eigen functies.utility-globals
TEMPobjectEen object voor tijdelijke gegevens; het framework vervangt het af en toe door een nieuw leeg object.utility-globals
NOWobjectDe huidige datum, door het framework eens per minuut ververst en door sommige aanroepen zoals CACHE.utility-globals
EMPTYARRAYobjectEen bevroren lege array, om te voorkomen dat er nieuwe worden gemaakt.utility-globals
EMPTYOBJECTobjectEen bevroren leeg object, om te voorkomen dat er nieuwe worden gemaakt.utility-globals
MODSobjectDe geladen modules van de map modules/, op id.utility-globals
PLUGINSobjectDe geladen plugins van de map plugins/, op id.utility-globals
NOOPfunctionEen functie die niets doet.utility-globals
printfunctionHetzelfde als console.log.utility-globals
REQUIREfunctionZoals require, maar zoekt ook in de map node_modules van de applicatie en accepteert node:-namen.utility-globals

Routing, acties en middleware

NaamSoortWat het doetRecept
ROUTEfunctionDeclareert een route (HTTP, SOCKET, FILE, API of een fallback zoals #404).http-methods
NEWACTIONfunctionDeclareert een actie met zijn input, params, query, output en rechten.actions-crud
NEWSCHEMAfunctionGroepeert de acties van een entiteit onder één naam.schemas
ACTIONfunctionVoert een actie uit vanuit je eigen code.calling-actions-from-code
EXECfunctionDezelfde functie als ACTION.calling-actions-from-code
NEWTRANSFORMfunctionVoegt een stap toe aan een benoemde keten van transformaties.transforms
TRANSFORMfunctionLaat een waarde door een keten van transformaties lopen.transforms
MIDDLEWAREfunctionRegistreert een middleware voor gebruik in routes met #name.middleware
NEWMIDDLEWAREfunctionDezelfde functie als MIDDLEWARE.middleware
PROXYfunctionStuurt de verzoeken onder een URL-voorvoegsel door naar een andere server.proxy
CORSfunctionStelt de origins in die de applicatie vanuit een browser mogen aanroepen.cors
ErrorBuilderfunctionDe klasse die validatiefouten verzamelt.errors-and-audit
SUCCESSfunctionGeeft het object terug dat het framework verstuurt bij een geslaagde bewerking ({ success: true, value: value }).errors-and-audit
ERRORfunctionERROR(name) geeft een callback terug die de ontvangen fout onder die naam logt; ERROR() geeft de standaard foutcallback terug.errors-and-audit
UNAUTHORIZEDfunctionUNAUTHORIZED($, ...permissions) antwoordt 401 en geeft true terug als de gebruiker geen van de rechten heeft; het geeft false terug als de gebruiker er een heeft of superbeheerder is.action-user-and-permissions
AUTHfunctionAuthenticeert elk verzoek: een functie, of de opties van de ingebouwde sessies.sessions-with-built-in-auth
BLOCKEDfunctionTelt de aanroepen van een IP-adres en meldt wanneer het de limiet heeft bereikt.rate-limiting
AUDITfunctionVoegt een auditregel (gebruiker, bericht en type) toe aan een logbestand in logs/.errors-and-audit

Gegevens en cache

NaamSoortWat het doetRecept
NOSQLfunctionOpent een tabel van de ingebouwde NoSQL-database.nosql-crud
DATAobjectDatabaseonafhankelijke ingang naar de query builder.data-api
DBfunctionStart een query met de query builder (DB().find('table').where(...).callback($)); de query wordt uitgevoerd door de driver die met NEWDB is geregistreerd.query-builder-db
NEWDBfunctionRegistreert een databasedriver function(options, callback) voor de query builder: de standaard, of een benoemde met NEWDB('name', fn).query-builder-db
CACHEobjectEen opslag in het geheugen met verloop.cache
FILECACHEfunctionBerekent een resultaat één keer en bewaart het een tijd in een bestand.filecache
MEMORIZEfunctionEen JSON-object opgeslagen op schijf.memorize
FILESTORAGEfunctionEen opslag voor geüploade bestanden.filestorage

HTTP-, WebSocket- en berichtenclients

NaamSoortWat het doetRecept
REQUESTfunctionHTTP-client op laag niveau.request-and-download
DOWNLOADfunctionSlaat het antwoord van een URL op in een bestand.request-and-download
RESTBuilderfunctionBuilder voor aanroepen van andere HTTP-API's.restbuilder
AJAXfunctionAJAX('METHOD /url/', data, callback) doet een verzoek met de header x-requested-with en geeft de geparsede body terug; het geeft een promise terug als er geen callback is.ajax-requests
APIfunctionRoept een bewerking van een externe dienst aan via zijn driver: API('service', 'operation', data).callback($).api-drivers
NEWAPIfunctionRegistreert de driver function(options, next) van een dienst voor API, met een optionele configuratie.api-drivers
TotalAPIfunctionRoept een dienst van het Total.js-platform aan via API('TAPI', name, model).remote-service-boundaries
WEBSOCKETCLIENTfunctionEen WebSocket-client voor je applicatie.websocket-client
TMSCLIENTfunctionEen client van de Total Messaging Service.tms
PUBLISHfunctionStuurt een bericht naar de TMS-clients die erop geabonneerd zijn.tms
NEWPUBLISHfunctionDeclareert een bericht dat de applicatie publiceert.tms
SUBSCRIBEfunctionVoegt een listener toe voor een bericht dat clients naar de applicatie sturen.tms
UNSUBSCRIBEfunctionVerwijdert de listeners van een TMS-bericht.tms
NEWSUBSCRIBEfunctionDeclareert een bericht dat de applicatie ontvangt.tms
NEWCALLfunctionDeclareert een functie die TMS-clients kunnen aanroepen.tms
OPENCLIENTfunctionVerbindt met OpenPlatform via WebSocket voor externe aanroepen, gebeurtenissen en gedeelde verbindingen.openclient-protocol
PROXYCLIENTfunctionVerbindt via WebSocket met een PROXYSERVER en beantwoordt zijn verzoeken met een lokale server (een poort of ip:port).proxy-tunnel
PROXYSERVERfunctionMaakt van de applicatie een tunnelserver: de HTTP-verzoeken van een endpoint worden via een WebSocket-route naar een PROXYCLIENT gestuurd.proxy-tunnel
LDAPfunctionMaakt verbinding met een LDAP-server (poort 389 tenzij ldap.port iets anders zegt) en roept terug met het resultaat.ldap-openldap
MAILfunctionVerstuurt een e-mail waarvan de body een view is.send-email
HTMLMAILfunctionVerstuurt een e-mail waarvan de body een HTML-string is.send-email
LOGMAILfunctionVerstuurt een e-mail waarvan de body een tekst is die in een <pre>-blok wordt afgedrukt (geef de body als tekst door).logmail
MailobjectDe klasse achter het versturen van e-mail (SMTP).send-email
AIMODELfunctionStart een verzoek aan een taalmodel dat met NEWAIMODEL is geregistreerd: AIMODEL('name').user('text').callback($.callback()).ai-models
AIPARSERfunctionMaakt een parser voor het gestreamde antwoord van een AI-aanbieder (openai, claude...): write() neemt stukken aan en end() geeft de inhoud, de redenering en de toolaanroepen terug.ai-models
NEWAIMODELfunctionRegistreert de driver function(ai, done) van een of meer AI-modellen voor AIMODEL, met een optionele configuratie.ai-models
PYPELINEfunctionVoert vanuit de applicatie een Python-bestand uit de map pypelines/ (of inline Python-code) uit en praat ermee via JSON-frames over een socket.pypeline

Bestanden, systeem en workers

NaamSoortWat het doetRecept
PATHobjectHelpers die paden bouwen in de projectmappen (PATH.root(), PATH.public(), PATH.tmp()...).file-download
MERGEfunctionRegistreert een virtueel, geminificeerd bestand dat uit meerdere bestanden bestaat.minification
TOUCHfunctionWist de gecachete geminificeerde, tijdelijke en niet-gevonden items van een URL, of van alle.touch-static-cache
CLEANUPfunctionVernietigt een stream wanneer die klaar is.cleanup-streams
BACKUPfunctionPakt een map in één bestand.backup-restore-shell
RESTOREfunctionPakt een met BACKUP gemaakt bestand uit.backup-restore-shell
SHELLfunctionVoert een shellcommando uit in de projectmap.backup-restore-shell
NPMINSTALLfunctionInstalleert een npm-pakket in de modulemap van de applicatie.load-and-npminstall
IMPORTfunctionDownloadt een JavaScript-bestand van een URL en laadt het.import-remote-module
ImageobjectBeeldverwerking met GraphicsMagick of ImageMagick.images
NEWTHREADfunctionStart een worker thread.workers-and-threads
NEWFORKfunctionStart een kindproces.workers-and-threads
NEWTHREADPOOLfunctionMaakt een pool van workers die taken één voor één lenen.thread-pool
CRONfunctionVoert een functie volgens een schema uit.cron-jobs
setTimeout2functionsetTimeout met een id: opnieuw aanroepen met dezelfde id vervangt de vorige timer.debounce-timers
clearTimeout2functionAnnuleert een met setTimeout2 gemaakte timer.debounce-timers
FlowobjectDe beheerder van de FlowStreams van de applicatie: Flow.load(schema), Flow.remove(id), Flow.instances en Flow.test() voor één component.flowstream, flowstream-component-test
FlowStreamobjectHetzelfde object als Flow.flowstream
NEWMACROfunctionCompileert een macro uit een string.macros
NEWCOMPONENTfunctionCompileert de HTML van een component.native-components
COMPONENTATORfunctionDownloadt een Componentator-bundel naar public/ als ui-<name>-<hash>.min.js en slaat het adres op in F.repo[name].remote-service-boundaries

Hulpmiddelen, templates en lokalisatie

NaamSoortWat het doetRecept
UobjectHet hulpobject van het framework (U.extend(), U.clone()...).utilities
UtilsobjectHetzelfde object als U.utilities
UIDfunctionMaakt een korte unieke id, gesorteerd op tijd.unique-ids-and-hashes
GUIDfunctionMaakt een willekeurige string van de opgegeven lengte.unique-ids-and-hashes
HASHfunctionGeeft een snelle numerieke hash terug (niet voor wachtwoorden).unique-ids-and-hashes
CLONEfunctionMaakt een diepe kopie van een object.utility-globals
COPYfunctionKopieert de eigenschappen van het eerste object naar het tweede en geeft het tweede terug.utility-globals
DIFFARRfunctionVergelijkt twee arrays van objecten op een eigenschap en geeft de objecten om toe te voegen, de paren om bij te werken en de waarden om te verwijderen.diffarr-sync-lists
QUERIFYfunctionBouwt een URL met querystring uit een object.utility-globals
PROMISIFYfunctionPROMISIFY(fn, a, b, c) roept een functie aan die een callback als laatste argument neemt en geeft een promise terug.utility-globals
ENCRYPTfunctionZet een waarde om in een ondoorzichtig token.encrypt-and-decrypt
DECRYPTfunctionLeest een waarde uit een met ENCRYPT gemaakt token.encrypt-and-decrypt
ENCRYPTREQfunctionVersleutelt een waarde samen met de user agent van een verzoek (en zijn IP-adres in strikte modus).request-bound-tokens
DECRYPTREQfunctionLeest een met ENCRYPTREQ gemaakte waarde; geeft niets terug als het verzoek niet overeenkomt.request-bound-tokens
LOCALIZEfunctionKiest de taal van elk verzoek.localization
TRANSLATEfunctionVertaalt de @(...)-teksten van een string naar een taal.localization
TangularobjectDe template-engine (Tangular.render()).tangular-templates
TaobjectEen andere naam voor Tangular, de template-engine.template-files
ThelpersobjectDe helperfuncties die beschikbaar zijn in Tangular-templates.tangular-templates
TEMPLATEfunctionRendert een Tangular-template die een tekst, een bestand uit de map templates of een URL is, en geeft een promise met de tekst terug.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);
}