ForgeDokumentation
de

Dokumentation

Globale Namen von Total.js 5

Total.js 5 · total5@0.0.19 referenceglobals Mit Total.js 5 ausgeführt

Total.js 5 zeigt globale Funktionen und Objekte für Routing, Aktionen, Speicherung, Nachrichten und Anwendungs-Tools.

NameArtWas es tutRezept
ONfunctionRegistriert einen Listener für ein Anwendungsereignis.events
ONCEfunctionWie ON, aber der Listener läuft nur beim ersten Ereignis.events
OFFfunctionEntfernt einen mit ON registrierten Listener.events
EMITfunctionSendet ein Ereignis mit bis zu sieben Argumenten.events
LOADfunctionLädt die Dateien des Projekts (Controller, Definitionen...); das Framework ruft es beim Start für dich auf.load-and-npminstall
LOADCONFIGfunctionParst einen Text im config-Format und wendet ihn auf CONF an.configuration-file
LOADRESOURCEfunctionLädt eine Ressource (eine Übersetzungsdatei) aus einem Text oder von einer URL.localization
PAUSESERVERfunctionPausiert oder setzt den Server nach Namen fort: Während der Pause erhalten Anfragen eine 503-Seite.pause-server
DEBUGbooleantrue im Debug-Modus, false im Release-Modus.release-mode-and-debugging
CONFobjectDie Konfiguration der Anwendung (die Datei config und ihre Standardwerte).configuration-file
DEFobjectStandard-Handler und -Einstellungen des Frameworks (DEF.onMail, DEF.helpers, DEF.onCSRFcheck...).view-helpers-and-config
FobjectDas Framework-Objekt. Total ist dasselbe Objekt.utility-globals
TotalobjectDas Framework-Objekt (wie F). Total.run() startet die Anwendung.release-mode-and-debugging
MAINobjectEin leeres Objekt, das das Framework für die Daten deiner Anwendung erzeugt.utility-globals
REPOobjectEin leeres Objekt, das das Framework für deine eigenen Daten erzeugt.utility-globals
FUNCobjectEin leeres Objekt, das das Framework für deine eigenen Funktionen erzeugt.utility-globals
TEMPobjectEin Objekt für temporäre Daten; das Framework ersetzt es von Zeit zu Zeit durch ein neues leeres Objekt.utility-globals
NOWobjectDas aktuelle Datum, vom Framework einmal pro Minute und von einigen Aufrufen wie CACHE aktualisiert.utility-globals
EMPTYARRAYobjectEin eingefrorenes leeres Array, um das Erzeugen neuer zu vermeiden.utility-globals
EMPTYOBJECTobjectEin eingefrorenes leeres Objekt, um das Erzeugen neuer zu vermeiden.utility-globals
MODSobjectDie geladenen Module des Ordners modules/, nach ID.utility-globals
PLUGINSobjectDie geladenen Plugins des Ordners plugins/, nach ID.utility-globals
NOOPfunctionEine Funktion, die nichts tut.utility-globals
printfunctionDasselbe wie console.log.utility-globals
REQUIREfunctionWie require, sucht aber auch im Ordner node_modules der Anwendung und akzeptiert node:-Namen.utility-globals

Routing, Actions und Middleware

NameArtWas es tutRezept
ROUTEfunctionDeklariert eine Route (HTTP, SOCKET, FILE, API oder einen Fallback wie #404).http-methods
NEWACTIONfunctionDeklariert eine Action mit Input, Params, Query, Output und Berechtigungen.actions-crud
NEWSCHEMAfunctionGruppiert die Actions einer Entität unter einem Namen.schemas
ACTIONfunctionFührt eine Action aus deinem eigenen Code aus.calling-actions-from-code
EXECfunctionDieselbe Funktion wie ACTION.calling-actions-from-code
NEWTRANSFORMfunctionFügt einer benannten Transformationskette einen Schritt hinzu.transforms
TRANSFORMfunctionSchickt einen Wert durch eine Transformationskette.transforms
MIDDLEWAREfunctionRegistriert eine Middleware zur Verwendung in Routen mit #name.middleware
NEWMIDDLEWAREfunctionDieselbe Funktion wie MIDDLEWARE.middleware
PROXYfunctionLeitet die Anfragen unter einem URL-Präfix an einen anderen Server weiter.proxy
CORSfunctionLegt die Origins fest, die die Anwendung aus einem Browser aufrufen dürfen.cors
ErrorBuilderfunctionDie Klasse, die Validierungsfehler sammelt.errors-and-audit
SUCCESSfunctionLiefert das Objekt, das das Framework bei einer erfolgreichen Operation sendet ({ success: true, value: value }).errors-and-audit
ERRORfunctionERROR(name) liefert einen Callback, der den empfangenen Fehler unter diesem Namen protokolliert; ERROR() liefert den Standard-Fehler-Callback.errors-and-audit
UNAUTHORIZEDfunctionUNAUTHORIZED($, ...permissions) antwortet 401 und liefert true, wenn der Benutzer keine der Berechtigungen hat; es liefert false, wenn er eine davon hat oder Super-Administrator ist.action-user-and-permissions
AUTHfunctionAuthentifiziert jede Anfrage: eine Funktion oder die Optionen der eingebauten Sessions.sessions-with-built-in-auth
BLOCKEDfunctionZählt die Aufrufe einer IP-Adresse und meldet, wann sie das Limit erreicht hat.rate-limiting
AUDITfunctionHängt einen Audit-Eintrag (Benutzer, Nachricht und Typ) an eine Logdatei in logs/ an.errors-and-audit

Daten und Cache

NameArtWas es tutRezept
NOSQLfunctionÖffnet eine Tabelle der eingebauten NoSQL-Datenbank.nosql-crud
DATAobjectDatenbankunabhängiger Einstieg in den Query Builder.data-api
DBfunctionStartet eine Abfrage mit dem Query Builder (DB().find('table').where(...).callback($)); die Abfrage führt der mit NEWDB registrierte Treiber aus.query-builder-db
NEWDBfunctionRegistriert einen Datenbanktreiber function(options, callback) für den Query Builder: den Standardtreiber oder einen benannten mit NEWDB('name', fn).query-builder-db
CACHEobjectEin Speicher im Arbeitsspeicher mit Ablauf.cache
FILECACHEfunctionBerechnet ein Ergebnis einmal und hält es eine Weile in einer Datei.filecache
MEMORIZEfunctionEin auf der Festplatte gespeichertes JSON-Objekt.memorize
FILESTORAGEfunctionEin Speicher für hochgeladene Dateien.filestorage

HTTP-, WebSocket- und Messaging-Clients

NameArtWas es tutRezept
REQUESTfunctionLow-Level-HTTP-Client.request-and-download
DOWNLOADfunctionSpeichert die Antwort einer URL in einer Datei.request-and-download
RESTBuilderfunctionBuilder für Aufrufe anderer HTTP-APIs.restbuilder
AJAXfunctionAJAX('METHOD /url/', data, callback) sendet eine Anfrage mit dem Header x-requested-with und liefert den geparsten Body; ohne Callback liefert es ein Promise.ajax-requests
APIfunctionRuft eine Operation eines externen Dienstes über seinen Treiber auf: API('service', 'operation', data).callback($).api-drivers
NEWAPIfunctionRegistriert den Treiber function(options, next) eines Dienstes für API, mit optionaler Konfiguration.api-drivers
TotalAPIfunctionRuft einen Dienst der Total.js-Plattform über API('TAPI', name, model) auf.remote-service-boundaries
WEBSOCKETCLIENTfunctionEin WebSocket-Client für deine Anwendung.websocket-client
TMSCLIENTfunctionEin Client des Total Messaging Service.tms
PUBLISHfunctionSendet eine Nachricht an die TMS-Clients, die sie abonniert haben.tms
NEWPUBLISHfunctionDeklariert eine Nachricht, die die Anwendung veröffentlicht.tms
SUBSCRIBEfunctionFügt einen Listener für eine Nachricht hinzu, die Clients an die Anwendung senden.tms
UNSUBSCRIBEfunctionEntfernt die Listener einer TMS-Nachricht.tms
NEWSUBSCRIBEfunctionDeklariert eine Nachricht, die die Anwendung empfängt.tms
NEWCALLfunctionDeklariert eine Funktion, die TMS-Clients aufrufen können.tms
OPENCLIENTfunctionVerbindet sich über WebSocket mit OpenPlatform für Fernaufrufe, Ereignisse und gemeinsame Verbindungen.openclient-protocol
PROXYCLIENTfunctionVerbindet sich per WebSocket mit einem PROXYSERVER und beantwortet dessen Anfragen mit einem lokalen Server (ein Port oder ip:port).proxy-tunnel
PROXYSERVERfunctionMacht die Anwendung zu einem Tunnel-Server: Die HTTP-Anfragen eines Endpunkts werden über eine WebSocket-Route an einen PROXYCLIENT gesendet.proxy-tunnel
LDAPfunctionVerbindet sich mit einem LDAP-Server (Port 389, sofern ldap.port nichts anderes sagt) und ruft mit dem Ergebnis zurück.ldap-openldap
MAILfunctionSendet eine E-Mail, deren Body eine View ist.send-email
HTMLMAILfunctionSendet eine E-Mail, deren Body ein HTML-String ist.send-email
LOGMAILfunctionSendet eine E-Mail, deren Body ein in einem <pre>-Block ausgegebener Text ist (übergeben Sie den Body als Text).logmail
MailobjectDie Klasse hinter dem E-Mail-Versand (SMTP).send-email
AIMODELfunctionStartet eine Anfrage an ein mit NEWAIMODEL registriertes Sprachmodell: AIMODEL('name').user('text').callback($.callback()).ai-models
AIPARSERfunctionErzeugt einen Parser für die gestreamte Antwort eines KI-Anbieters (openai, claude...): write() nimmt Teile entgegen und end() liefert Inhalt, Denkprozess und Tool-Aufrufe.ai-models
NEWAIMODELfunctionRegistriert den Treiber function(ai, done) eines oder mehrerer KI-Modelle für AIMODEL, mit optionaler Konfiguration.ai-models
PYPELINEfunctionFührt aus der Anwendung eine Python-Datei des Ordners pypelines/ (oder Inline-Python-Code) aus und spricht mit ihr über JSON-Frames auf einem Socket.pypeline

Dateien, System und Worker

NameArtWas es tutRezept
PATHobjectHelper, die Pfade in den Projektordnern bauen (PATH.root(), PATH.public(), PATH.tmp()...).file-download
MERGEfunctionRegistriert eine virtuelle, minifizierte Datei aus mehreren Dateien.minification
TOUCHfunctionLeert die zwischengespeicherten minifizierten, temporären und Nicht-gefunden-Einträge einer URL oder aller.touch-static-cache
CLEANUPfunctionZerstört einen Stream, wenn er beendet ist.cleanup-streams
BACKUPfunctionPackt ein Verzeichnis in eine Datei.backup-restore-shell
RESTOREfunctionEntpackt eine mit BACKUP erstellte Datei.backup-restore-shell
SHELLfunctionFührt einen Shell-Befehl im Projektordner aus.backup-restore-shell
NPMINSTALLfunctionInstalliert ein npm-Paket im Modulordner der Anwendung.load-and-npminstall
IMPORTfunctionLädt eine JavaScript-Datei von einer URL herunter und lädt sie.import-remote-module
ImageobjectBildverarbeitung mit GraphicsMagick oder ImageMagick.images
NEWTHREADfunctionStartet einen Worker-Thread.workers-and-threads
NEWFORKfunctionStartet einen Kindprozess.workers-and-threads
NEWTHREADPOOLfunctionErstellt einen Pool von Workern, die sich die Aufgaben nacheinander ausleihen.thread-pool
CRONfunctionFührt eine Funktion nach Zeitplan aus.cron-jobs
setTimeout2functionsetTimeout mit einer ID: Ein erneuter Aufruf mit derselben ID ersetzt den vorherigen Timer.debounce-timers
clearTimeout2functionBricht einen mit setTimeout2 erstellten Timer ab.debounce-timers
FlowobjectDer Manager der FlowStreams der Anwendung: Flow.load(schema), Flow.remove(id), Flow.instances und Flow.test() für eine Komponente.flowstream, flowstream-component-test
FlowStreamobjectDasselbe Objekt wie Flow.flowstream
NEWMACROfunctionKompiliert ein Makro aus einem String.macros
NEWCOMPONENTfunctionKompiliert das HTML einer Komponente.native-components
COMPONENTATORfunctionLädt ein Componentator-Paket nach public/ als ui-<name>-<hash>.min.js und speichert seine Adresse in F.repo[name].remote-service-boundaries

Hilfsfunktionen, Templates und Lokalisierung

NameArtWas es tutRezept
UobjectDas Hilfsobjekt des Frameworks (U.extend(), U.clone()...).utilities
UtilsobjectDasselbe Objekt wie U.utilities
UIDfunctionErzeugt eine kurze eindeutige, nach Zeit sortierte ID.unique-ids-and-hashes
GUIDfunctionErzeugt einen zufälligen String der angegebenen Länge.unique-ids-and-hashes
HASHfunctionLiefert einen schnellen numerischen Hash (nicht für Passwörter).unique-ids-and-hashes
CLONEfunctionErstellt eine tiefe Kopie eines Objekts.utility-globals
COPYfunctionKopiert die Eigenschaften des ersten Objekts in das zweite und liefert das zweite.utility-globals
DIFFARRfunctionVergleicht zwei Arrays von Objekten anhand einer Eigenschaft und liefert die hinzuzufügenden Objekte, die zu aktualisierenden Paare und die zu entfernenden Werte.diffarr-sync-lists
QUERIFYfunctionBaut aus einem Objekt eine URL mit Query-String.utility-globals
PROMISIFYfunctionPROMISIFY(fn, a, b, c) ruft eine Funktion auf, die als letztes Argument einen Callback nimmt, und liefert ein Promise.utility-globals
ENCRYPTfunctionWandelt einen Wert in ein undurchsichtiges Token um.encrypt-and-decrypt
DECRYPTfunctionLiest einen Wert aus einem mit ENCRYPT erstellten Token.encrypt-and-decrypt
ENCRYPTREQfunctionVerschlüsselt einen Wert zusammen mit dem User-Agent einer Anfrage (und ihrer IP-Adresse im strengen Modus).request-bound-tokens
DECRYPTREQfunctionLiest einen mit ENCRYPTREQ erstellten Wert; liefert nichts, wenn die Anfrage nicht passt.request-bound-tokens
LOCALIZEfunctionWählt die Sprache jeder Anfrage.localization
TRANSLATEfunctionÜbersetzt die @(...)-Texte eines Strings in eine Sprache.localization
TangularobjectDie Template-Engine (Tangular.render()).tangular-templates
TaobjectEin anderer Name für Tangular, die Template-Engine.template-files
ThelpersobjectDie in Tangular-Templates verfügbaren Helper-Funktionen.tangular-templates
TEMPLATEfunctionRendert ein Tangular-Template, das ein Text, eine Datei des Ordners templates oder eine URL ist, und liefert ein Promise mit dem Text.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);
}