diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 8f3c8a6ce..85fc1f92a 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -5,6 +5,9 @@ on:
release:
types: [published]
+permissions:
+ contents: read
+
jobs:
generate:
name: 'Update node-red-docker image'
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 0db909da6..27b1f683f 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -6,12 +6,18 @@ on:
pull_request:
branches: [ master, dev ]
+permissions:
+ contents: read
+
jobs:
build:
+ permissions:
+ checks: write # for coverallsapp/github-action to create new checks
+ contents: read # for actions/checkout to fetch code
runs-on: ubuntu-latest
strategy:
matrix:
- node-version: [14, 16]
+ node-version: [16, 18]
steps:
- uses: actions/checkout@v2
- name: Use Node.js ${{ matrix.node-version }}
@@ -24,7 +30,7 @@ jobs:
run: |
npm run test
- name: Publish to coveralls.io
- if: ${{ matrix.node-version == 14 }}
+ if: ${{ matrix.node-version == 16 }}
uses: coverallsapp/github-action@v1.1.2
with:
github-token: ${{ github.token }}
diff --git a/.jshintrc b/.jshintrc
index 719eecb49..0886c1dc0 100644
--- a/.jshintrc
+++ b/.jshintrc
@@ -15,5 +15,5 @@
"shadow": true, // allow variable shadowing (re-use of names...)
"sub": true, // don't warn that foo['bar'] should be written as foo.bar
"proto": true, // allow setting of __proto__ in node < v0.12,
- "esversion": 6 // allow es6
+ "esversion": 11 // allow es11(ES2020)
}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6c6f52aeb..04fd110ba 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,128 @@
+#### 3.1.0-beta.1: Beta Release
+
+
+Editor
+
+ - NEW: Locking Flows (#3938) @knolleary
+ - NEW: Improve UX around hiding flows via context menu (#3930) @knolleary
+ - NEW: Add support for inline image in markdown editor by drag and drop of an image file (#4006) @HiroyasuNishiyama
+ - NEW: Add support for mermaid diagram to markdown editor (#4007) @HiroyasuNishiyama
+ - NEW: Support uri fragments for nodes and groups including edit support (#3870) @knolleary
+ - NEW: Add global environment variable feature (#3941) @HiroyasuNishiyama
+
+ - Remember compact/pretty flow export user choice (#3974) @Steve-Mcl
+ - fix .red-ui-notification class (#4035) @xiaobinqt
+ - Fix border radius on Modules list header (#4038) @bonanitech
+ - fix workspace reference error in case of empty tabs (#4029) @HiroyasuNishiyama
+ - Disable delete tab menu when single tab exists (#4030) @HiroyasuNishiyama
+ - Disable hide all menu if all tabs hidden (#4031) @HiroyasuNishiyama
+ - fix hide subflow tooltip (#4033) @HiroyasuNishiyama
+ - Fix disabled menu items in project feature (#4027) @kazuhitoyokoi
+ - Let themes change radialMenu text colors (#3995) @bonanitech
+ - Add Japanese translations for v3.0.3 (#4012) @kazuhitoyokoi
+ - Add Japanese translation for v3.1.0-beta.0 (#3997) @kazuhitoyokoi
+ - Add Japanese translation for v3.1.0-beta.0 (#3916) @kazuhitoyokoi
+ - Hide subflow category after deleting subflow (#3980) @kazuhitoyokoi
+ - Prevent dbl-click opening node edit dialog with text selected (#3970) @knolleary
+ - Handle replacing unknown node inside group or subflow (#3921) @knolleary
+ - Fix #3939, red border red-ui-typedInput-container (#3949) @Steveorevo
+ - i18n item URL copy notification & add Japanese message (#3946) @HiroyasuNishiyama
+ - add Japanese message for item url copy actions (#3947) @HiroyasuNishiyama
+ - Fix autocomplete entry for responseUrl (#3884) @knolleary
+ - Fix Japanese translation for JSONata editor (#3872) @HiroyasuNishiyama
+ - Fix search type with spaces (#3841) @Steve-Mcl
+ - Fix error hanndling of JSONata expression editor for extended functions (#3871) @HiroyasuNishiyama
+ - Add button type to the adding SSH key button (#3866) @kazuhitoyokoi
+ - Check radio button as default in project dialog (#3879) @kazuhitoyokoi
+ - Add $clone as supported function (#3874) @HiroyasuNishiyama
+ - Env var jsonata (#3807) @HiroyasuNishiyama
+ - Add Japanese translation for v3.0.2 (#3852) @kazuhitoyokoi
+
+Runtime
+
+ - Force IPv4 name resolution to have priority (#4019) @dceejay
+ - Fix async loading of modules containing both nodes and plugins (#3999) @knolleary
+ - Use main branch as default in project feature (#4036) @kazuhitoyokoi
+ - Rename package var to avoid strict mode error (#4020) @knolleary
+ - Fix typos in settings.js (#4013) @ypid
+ - Ensure credentials object is removed before returning node in getFlow request (#3971) @knolleary
+ - Ignore commit error in project feature (#3987) @kazuhitoyokoi
+ - Update dependencies (#3969) @knolleary
+ - Add check that node sends object rather than primitive type (#3909) @knolleary
+ - Ensure key_path is quoted in GIT_SSH_COMMAND in case of spaces in pathname (#3912) @knolleary
+ - Fix nodesDir scan when node package has js/html in sub dir to package.json (#3867) @Steve-Mcl
+ - Fix file permissions (#3917) @kazuhitoyokoi
+ - ci: add minimum GitHub token permissions for workflows (#3907) @boahc077
+
+Nodes
+
+ - Catch: fix typo in catch.html (#3965) @we11adam
+ - Change: Fix change node overwriting msg with itself (#3899) @dceejay
+ - Comment node: Clarify where the text will appear (#4004) @dirkjanfaber
+ - CSV: change replace to replaceAll (#3990) @dceejay
+ - CSV node: check header properties for ' and " (#3920) @dceejay
+ - CSV: Fix for CSV undefined property (#3906) @dceejay
+ - Delay: let delay node handle both flush then reset (#3898) @dceejay
+ - Function: Limit number of ports in function node (#3886) @kazuhitoyokoi
+ - Function: Remove dot from variable name for external module in function node (#3880) @kazuhitoyokoi
+ - Function: add function node monaco types util and promisify (#3868) @Steve-Mcl
+ - HTTP In: Ensure msg.req.headers is enumerable (#3908) @knolleary
+ - HTTP Request: Support form-data arrays (#3991) @hardillb
+ - HTTP Request: Fix httprequest tests to be more lenient on error message (#3922) @knolleary
+ - HTTP Request: Add missing property to node object HTTPRequest (#3842) @hardillb
+ - HTTP Request/Response: Support sortable list on property UI of http request and http response nodes (#3857) @kazuhitoyokoi
+ - HTTP Response: Ensure statusCode is a number (#3894) @hardillb
+ - Inject: Allow Inject node to work with async context stores (#4021) @knolleary
+ - Join/Batch: Add count to join and batch node labels (#4028) @dceejay
+ - MQTT: Fix birth topic handling in MQTT node (#3905) @Steve-Mcl
+ - MQTT: Fix pull-down menus of MQTT configuration node (#3890) @kazuhitoyokoi
+ - MQTT: Prevent invalid mqtt birth topic crashing node-red (#3869) @Steve-Mcl
+ - MQTT: ensure sessionExpiry(Interval) is applied (#3840) @Steve-Mcl
+ - MQTT: Fix mqtt nodes not reconnecting on modified-flows deploy (#3992) @knolleary
+ - MQTT: fix single subscription mqtt node status (#3966) @Steve-Mcl
+ - Range: Add drop mode to range node (#3935) @dceejay
+ - Remove done from describe (#3873) @HiroyasuNishiyama
+ - Split node: avoid duplicate done call for buffer split (#4000) @knolleary
+ - Status: Fix typo in 25-status.html (#3981) @kazuhitoyokoi
+ - TCP Node: ensure newline substitution applies to whole message (#4009) @dceejay
+ - Template: Add information about environment variable to template node (#3882) @kazuhitoyokoi
+ - Trigger: Hide trigger node repeat send option if sending nothing (#4023) @dceejay
+ - Watch: fix watch node test on MacOS/ARM (#3942) @HiroyasuNishiyama
+
+#### 3.0.2: Maintenance Release
+
+Editor
+
+ - Fix workspace chart bottom property (#3812) @bonanitech
+ - Update german translation (#3802) @Dennis14e
+ - Support color reset to the default in subflow and group (#3801) @kazuhitoyokoi
+ - Allow generateNodeNames to handle names containing regex control chars (#3817) @knolleary
+ - Hide scrollbars until they're needed (#3808) @bonanitech
+ - Include junctions/groups when exporting subflows plus related fixes (#3816) @knolleary
+ - remove console.log (#3820) @Steve-Mcl
+
+Runtime
+
+ - Register subflow module instance node with parent flow (#3818) @knolleary
+
+Nodes
+
+ - HTTP Request: Allow HTTP Headers not in spec (#3776) @hardillb
+
+#### 3.0.1: Maintenance Release
+
+Editor
+
+ - Allow codeEditor theme to be set even if `codeEditor` is not set in settings.js (#3794) @Steve-Mcl
+ - Sys info (diagnostics report) amendments (#3793) @Steve-Mcl
+ - Allow `mode` and `title` to be omitted in `options` argument for `createEditor` (#3791) @Steve-Mcl
+ - Fix focus issues (#3789) @Steve-Mcl
+ - Ensure all typedInput buttons have button type set (#3788) @knolleary
+ - Do not flag hasUsers=false nodes as unused in search (#3787) @knolleary
+ - Properly position quick-add dialog in all cases (#3786) @knolleary
+ - Ensure quick-add dialog does not obscure ghost node when shifted (#3785) @knolleary
+ - Remove use of Object.hasOwn (#3784) @knolleary
+
#### 3.0.0: Milestone Release
Editor
diff --git a/Gruntfile.js b/Gruntfile.js
index 2f81da923..44f4c97f6 100644
--- a/Gruntfile.js
+++ b/Gruntfile.js
@@ -151,6 +151,7 @@ module.exports = function(grunt) {
"packages/node_modules/@node-red/editor-client/src/js/font-awesome.js",
"packages/node_modules/@node-red/editor-client/src/js/history.js",
"packages/node_modules/@node-red/editor-client/src/js/validators.js",
+ "packages/node_modules/@node-red/editor-client/src/js/ui/mermaid.js",
"packages/node_modules/@node-red/editor-client/src/js/ui/utils.js",
"packages/node_modules/@node-red/editor-client/src/js/ui/common/editableList.js",
"packages/node_modules/@node-red/editor-client/src/js/ui/common/treeList.js",
@@ -169,6 +170,7 @@ module.exports = function(grunt) {
"packages/node_modules/@node-red/editor-client/src/js/ui/diagnostics.js",
"packages/node_modules/@node-red/editor-client/src/js/ui/diff.js",
"packages/node_modules/@node-red/editor-client/src/js/ui/keyboard.js",
+ "packages/node_modules/@node-red/editor-client/src/js/ui/env-var.js",
"packages/node_modules/@node-red/editor-client/src/js/ui/workspaces.js",
"packages/node_modules/@node-red/editor-client/src/js/ui/statusBar.js",
"packages/node_modules/@node-red/editor-client/src/js/ui/view.js",
@@ -224,7 +226,7 @@ module.exports = function(grunt) {
"node_modules/jsonata/jsonata-es5.min.js",
"packages/node_modules/@node-red/editor-client/src/vendor/jsonata/formatter.js",
"packages/node_modules/@node-red/editor-client/src/vendor/ace/ace.js",
- "packages/node_modules/@node-red/editor-client/src/vendor/ace/ext-language_tools.js",
+ "packages/node_modules/@node-red/editor-client/src/vendor/ace/ext-language_tools.js"
],
// "packages/node_modules/@node-red/editor-client/public/vendor/vendor.css": [
// // TODO: resolve relative resource paths in
@@ -233,6 +235,9 @@ module.exports = function(grunt) {
"packages/node_modules/@node-red/editor-client/public/vendor/ace/worker-jsonata.js": [
"node_modules/jsonata/jsonata-es5.min.js",
"packages/node_modules/@node-red/editor-client/src/vendor/jsonata/worker-jsonata.js"
+ ],
+ "packages/node_modules/@node-red/editor-client/public/vendor/mermaid/mermaid.min.js": [
+ "node_modules/mermaid/dist/mermaid.min.js"
]
}
}
@@ -403,7 +408,7 @@ module.exports = function(grunt) {
{
cwd: 'packages/node_modules/@node-red/editor-client/src',
src: [
- 'types/node/*.ts',
+ 'types/node/**/*.ts',
'types/node-red/*.ts',
],
expand: true,
diff --git a/package.json b/package.json
index b596e10b6..baa9734a8 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "node-red",
- "version": "3.1.0-beta.0",
+ "version": "3.1.0-beta.1",
"description": "Low-code programming for event-driven applications",
"homepage": "http://nodered.org",
"license": "Apache-2.0",
@@ -26,30 +26,30 @@
}
],
"dependencies": {
- "acorn": "8.7.1",
+ "acorn": "8.8.2",
"acorn-walk": "8.2.0",
- "ajv": "8.11.0",
- "async-mutex": "0.3.2",
+ "ajv": "8.12.0",
+ "async-mutex": "0.4.0",
"basic-auth": "2.0.1",
"bcryptjs": "2.4.3",
- "body-parser": "1.20.0",
+ "body-parser": "1.20.2",
"cheerio": "1.0.0-rc.10",
"clone": "2.1.2",
- "content-type": "1.0.4",
+ "content-type": "1.0.5",
"cookie": "0.5.0",
"cookie-parser": "1.4.6",
"cors": "2.8.5",
"cronosjs": "1.7.1",
- "denque": "2.0.1",
- "express": "4.18.1",
+ "denque": "2.1.0",
+ "express": "4.18.2",
"express-session": "1.17.3",
"form-data": "4.0.0",
"fs-extra": "10.1.0",
- "got": "11.8.5",
+ "got": "11.8.6",
"hash-sum": "2.0.0",
- "hpagent": "1.0.0",
+ "hpagent": "1.2.0",
"https-proxy-agent": "5.0.1",
- "i18next": "21.8.14",
+ "i18next": "21.10.0",
"iconv-lite": "0.6.3",
"is-utf8": "0.2.1",
"js-yaml": "4.1.0",
@@ -60,7 +60,7 @@
"memorystore": "1.6.7",
"mime": "3.0.0",
"moment": "2.29.4",
- "moment-timezone": "0.5.34",
+ "moment-timezone": "0.5.41",
"mqtt": "4.3.7",
"multer": "1.4.5-lts.1",
"mustache": "4.2.0",
@@ -72,21 +72,21 @@
"passport": "0.6.0",
"passport-http-bearer": "1.0.1",
"passport-oauth2-client-password": "0.1.2",
- "raw-body": "2.5.1",
- "semver": "7.3.7",
- "tar": "6.1.11",
- "tough-cookie": "4.0.0",
- "uglify-js": "3.16.2",
- "uuid": "8.3.2",
+ "raw-body": "2.5.2",
+ "semver": "7.3.8",
+ "tar": "6.1.13",
+ "tough-cookie": "4.1.2",
+ "uglify-js": "3.17.4",
+ "uuid": "9.0.0",
"ws": "7.5.6",
"xml2js": "0.4.23"
},
"optionalDependencies": {
- "bcrypt": "5.0.1"
+ "bcrypt": "5.1.0"
},
"devDependencies": {
- "dompurify": "2.3.9",
- "grunt": "1.5.3",
+ "dompurify": "2.4.1",
+ "grunt": "1.6.1",
"grunt-chmod": "~1.1.1",
"grunt-cli": "~1.4.3",
"grunt-concurrent": "3.0.0",
@@ -108,17 +108,18 @@
"i18next-http-backend": "1.4.1",
"jquery-i18next": "1.2.1",
"jsdoc-nr-template": "github:node-red/jsdoc-nr-template",
- "marked": "4.0.18",
+ "marked": "4.2.12",
+ "mermaid": "^9.3.0",
"minami": "1.2.3",
"mocha": "9.2.2",
"node-red-node-test-helper": "^0.3.0",
- "nodemon": "2.0.19",
+ "nodemon": "2.0.20",
"proxy": "^1.0.2",
- "sass": "1.53.0",
+ "sass": "1.58.3",
"should": "13.2.3",
"sinon": "11.1.2",
"stoppable": "^1.1.0",
- "supertest": "6.2.4"
+ "supertest": "6.3.3"
},
"engines": {
"node": ">=14"
diff --git a/packages/node_modules/@node-red/editor-api/lib/editor/theme.js b/packages/node_modules/@node-red/editor-api/lib/editor/theme.js
index 7be8868d3..c21a7e6e7 100644
--- a/packages/node_modules/@node-red/editor-api/lib/editor/theme.js
+++ b/packages/node_modules/@node-red/editor-api/lib/editor/theme.js
@@ -327,9 +327,8 @@ module.exports = {
themeContext.header.url = themePlugin.header.url || themeContext.header.url
}
}
- if(theme.codeEditor) {
- theme.codeEditor.options = Object.assign({}, themePlugin.monacoOptions, theme.codeEditor.options);
- }
+ theme.codeEditor = theme.codeEditor || {}
+ theme.codeEditor.options = Object.assign({}, themePlugin.monacoOptions, theme.codeEditor.options);
}
activeThemeInitialised = true;
}
diff --git a/packages/node_modules/@node-red/editor-api/package.json b/packages/node_modules/@node-red/editor-api/package.json
index dd7020e75..5afcfead2 100644
--- a/packages/node_modules/@node-red/editor-api/package.json
+++ b/packages/node_modules/@node-red/editor-api/package.json
@@ -1,6 +1,6 @@
{
"name": "@node-red/editor-api",
- "version": "3.1.0-beta.0",
+ "version": "3.1.0-beta.1",
"license": "Apache-2.0",
"main": "./lib/index.js",
"repository": {
@@ -16,14 +16,14 @@
}
],
"dependencies": {
- "@node-red/util": "3.1.0-beta.0",
- "@node-red/editor-client": "3.1.0-beta.0",
+ "@node-red/util": "3.1.0-beta.1",
+ "@node-red/editor-client": "3.1.0-beta.1",
"bcryptjs": "2.4.3",
- "body-parser": "1.20.0",
+ "body-parser": "1.20.2",
"clone": "2.1.2",
"cors": "2.8.5",
"express-session": "1.17.3",
- "express": "4.18.1",
+ "express": "4.18.2",
"memorystore": "1.6.7",
"mime": "3.0.0",
"multer": "1.4.5-lts.1",
@@ -35,6 +35,6 @@
"ws": "7.5.6"
},
"optionalDependencies": {
- "bcrypt": "5.0.1"
+ "bcrypt": "5.1.0"
}
}
diff --git a/packages/node_modules/@node-red/editor-client/locales/de/editor.json b/packages/node_modules/@node-red/editor-client/locales/de/editor.json
old mode 100755
new mode 100644
index 41fe1459a..f2955c266
--- a/packages/node_modules/@node-red/editor-client/locales/de/editor.json
+++ b/packages/node_modules/@node-red/editor-client/locales/de/editor.json
@@ -105,7 +105,7 @@
"search": "Flows durchsuchen",
"searchInput": "Flows durchsuchen",
"subflows": "Subflow",
- "createSubflow": "Subflow",
+ "createSubflow": "Hinzufügen",
"selectionToSubflow": "Auswahl in Subflow umwandeln",
"flows": "Flow",
"add": "Hinzufügen",
@@ -152,7 +152,8 @@
"zoom-in": "Vergrößern",
"search-flows": "Flows durchsuchen",
"search-prev": "Vorherige",
- "search-next": "Nächste"
+ "search-next": "Nächste",
+ "search-counter": "\"__term__\" __result__ von __count__"
},
"user": {
"loggedInAs": "Angemeldet als __name__",
@@ -168,7 +169,11 @@
}
},
"notification": {
- "warning": "Warnung: __message__",
+ "state": {
+ "flowsStopped": "Flows gestoppt",
+ "flowsStarted": "Flows gestartet"
+ },
+ "warning": "Warnung: __message__",
"warnings": {
"undeployedChanges": "Node hat nicht übernommene (deploy) Änderungen",
"nodeActionDisabled": "Node-Aktionen deaktiviert",
@@ -177,15 +182,15 @@
"missing-modules": "
Flows angehalten aufgrund fehlender Module
",
"safe-mode": "
Flows sind im abgesicherten Modus gestoppt.
Flows können bearbeitet und übernommen (deploy) werden, um sie neu zu starten.
",
"restartRequired": "Node-RED muss neu gestartet werden, damit die Module nach Upgrade aktiviert werden",
- "credentials_load_failed": "
Flows gestoppt, da die Berechtigungen nicht entschlüsselt werden konnten.
Die Datei mit dem Flow-Berechtigungen ist verschlüsselt, aber der Schlüssel des Projekts fehlt oder ist ungültig.
",
- "credentials_load_failed_reset": "
Die Berechtigungen konnten nicht entschlüsselt werden.
Die Datei mit den Flow-Berechtigungen ist verschlüsselt, aber der Schlüssel des Projekts fehlt oder ist ungültig.
Die Datei mit den Flow-Berechtigungen wird bei der nächsten Übernahme (deploy) zurückgesetzt. Alle vorhandenen Flow-Berechtigungen werden gelöscht.
",
+ "credentials_load_failed": "
Flows gestoppt, da die Credentials nicht entschlüsselt werden konnten.
Die Datei mit den Flow-Credentials ist verschlüsselt, aber der Schlüssel des Projekts fehlt oder ist ungültig.
",
+ "credentials_load_failed_reset": "
Die Credentials konnten nicht entschlüsselt werden.
Die Datei mit den Flow-Credentials ist verschlüsselt, aber der Schlüssel des Projekts fehlt oder ist ungültig.
Die Datei mit den Flow-Credentials wird bei der nächsten Übernahme (deploy) zurückgesetzt. Alle vorhandenen Flow-Credentials werden gelöscht.
",
"missing_flow_file": "
Die Flow-Datei des Projekts wurde nicht gefunden.
Das Projekt ist nicht mit einer Flow-Datei konfiguriert.
",
"missing_package_file": "
Die Paket-Datei des Projekts wurde nicht gefunden.
In dem Projekt fehlt die 'package.json'-Datei.
",
"project_empty": "
Das Projekt ist leer.
Soll ein Standardsatz an Projektdateien erstellen werden? Andernfalls müssen die Dateien manuell außerhalb des Editors dem Projekt hinzugefügt werden.
",
"project_not_found": "
Das Projekt '__project__' wurde nicht gefunden.
",
"git_merge_conflict": "
Der automatische Merge der Änderungen ist fehlgeschlagen.
Die Merge-Konflikte müssen behoben und die Ergebnisse ins Repository übertragen werden (commit).
"
},
- "error": "Fehler: __message__",
+ "error": "Fehler: __message__",
"errors": {
"lostConnection": "Verbindung zum Server verloren. Verbindung wird erneut hergestellt ...",
"lostConnectionReconnect": "Verbindung zum Server verloren. Wiederherstellung der Verbindung in __time__s.",
@@ -203,7 +208,7 @@
"pull": "Projekt '__project__' erneut geladen",
"revert": "Änderungen im Projekt '__project__' rückgängig gemacht",
"merge-complete": "Git-Merge abgeschlossen",
- "setupCredentials": "Berechtigungen einrichten",
+ "setupCredentials": "Credentials einrichten",
"setupProjectFiles": "Projektdateien einrichten",
"no": "Nein, Danke",
"createDefault": "Standardprojektdateien erstellen",
@@ -211,7 +216,7 @@
},
"label": {
"manage-project-dep": "Projektabhängigkeiten verwalten",
- "setup-cred": "Berechtigungen einrichten",
+ "setup-cred": "Credentials einrichten",
"setup-project": "Projektdateien einrichten",
"create-default-package": "Standardpaketdatei erstellen",
"no-thanks": "Nein, Danke",
@@ -295,6 +300,10 @@
"modifiedFlowsDesc": "Übernimmt nur Flows, die geänderte Nodes enthalten",
"modifiedNodes": "Geänderte Nodes",
"modifiedNodesDesc": "Übernimmt nur Nodes, die sich geändert haben",
+ "startFlows": "Start",
+ "startFlowsDesc": "Flows starten",
+ "stopFlows": "Stop",
+ "stopFlowsDesc": "Flows stoppen",
"restartFlows": "Flows neustarten",
"restartFlowsDesc": "Startet die aktuell übernommenen Flows (ohne vorheriges Deploy)",
"successfulDeploy": "Erfolgreich übernommen (deploy)",
@@ -376,7 +385,7 @@
"confirmDelete": "Sind Sie sicher mit dem Löschen dieses Subflows?",
"info": "Beschreibung",
"category": "Kategorie",
- "module": "Module",
+ "module": "Modul",
"license": "Lizenz",
"licenseNone": "Keine",
"licenseOther": "Andere",
@@ -434,7 +443,7 @@
"icon": "Icon",
"inputType": "Eingangstyp",
"selectType": "Wähle Typen ...",
- "loadCredentials": "Lade Node-Berechtigungen",
+ "loadCredentials": "Lade Node-Credentials",
"inputs": {
"input": "Eingang",
"select": "Auswahl",
@@ -450,7 +459,7 @@
"json": "JSON",
"bin": "buffer",
"env": "Umgebungsvariable",
- "cred": "Berechtigung"
+ "cred": "Credentials"
},
"menu": {
"input": "Eingang",
@@ -470,7 +479,7 @@
"errors": {
"scopeChange": "Wenn Sie den Geltungsbereich (scope) ändern, wird er für Nodes in anderen Flows nicht verfügbar sein",
"invalidProperties": "Ungültige Eigenschaften:",
- "credentialLoadFailed": "Laden der Node-Berechtigungen fehlgeschlagen"
+ "credentialLoadFailed": "Laden der Node-Credentials fehlgeschlagen"
}
},
"keyboard": {
@@ -683,7 +692,8 @@
"showHelp": "Hilfe zeigen",
"showInOutline": "Zeige im Editor",
"showTopics": "Zeige Hilfethemen",
- "noHelp": "Kein Hilfethema ausgewählt"
+ "noHelp": "Kein Hilfethema ausgewählt",
+ "changeLog": "Änderungsprotokoll"
},
"config": {
"name": "Konfigurations-Node",
@@ -737,7 +747,7 @@
"addToProject": "Zu Projekt hinzufügen",
"files": "Dateien",
"flow": "Flow",
- "credentials": "Berechtigungen",
+ "credentials": "Credentials",
"package": "Paket",
"packageCreate": "Datei wird erstellt beim Speichern der Änderungen",
"fileNotExist": "Datei existiert nicht",
@@ -750,7 +760,7 @@
"changeTheEncryptionKey": "Schlüssel ändern",
"currentKey": "Aktueller Schlüssel",
"newKey": "Neuer Schlüssel",
- "credentialsAlert": "Dadurch werden alle vorhandenen Berechtigungen gelöscht",
+ "credentialsAlert": "Dadurch werden alle vorhandenen Credentials gelöscht",
"versionControl": "Versionsverwaltung (Git)",
"branches": "Branches",
"noBranches": "Keine Branches",
@@ -886,7 +896,7 @@
"date": "timestamp",
"jsonata": "JSONata",
"env": "Umgebungsvariable",
- "cred": "Berechtigung"
+ "cred": "Credentials"
}
},
"editableList": {
@@ -1026,7 +1036,7 @@
"passphrase": "Passphrase",
"ssh-key-desc": "Bevor Sie ein Repository über SSH lokal klonen können, müssen Sie einen SSH-Schlüssel hinzufügen, um auf diesen zugreifen zu können",
"ssh-key-add": "SSH-Schlüssel hinzufügen",
- "credential-key": "Schlüssel für Berechtigungen",
+ "credential-key": "Schlüssel für Credentials",
"cant-get-ssh-key": "Fehler! Der ausgewählte SSH-Schlüsselpfad kann nicht abgerufen werden",
"already-exists2": "bereits vorhanden",
"git-error": "Git-Fehler",
@@ -1038,27 +1048,27 @@
"create": "Erstellen Sie Ihre Projektdateien",
"desc0": "Ein Projekt enthält Ihre Flow-Dateien, eine README-Datei und die 'package.json'-Datei.",
"desc1": "Es kann alle anderen Dateien enthalten, die im Git-Repository verwaltet werden sollen.",
- "desc2": "Ihre vorhandenen Flow- und Berechtigungs-Dateien werden in das Projekt kopiert.",
+ "desc2": "Ihre vorhandenen Flow- und Credential-Dateien werden in das Projekt kopiert.",
"flow-file": "Flow-Datei",
- "credentials-file": "Datei mit Berechtigungen"
+ "credentials-file": "Datei mit Credentials"
},
"encryption-config": {
- "setup": "Einrichtung der Verschlüsselung Ihrer Datei mit den Berechtigungen",
- "desc0": "Die Datei mit den Flow-Berechtigungen kann verschlüsselt werden, um ihren Inhalt zu schützen.",
- "desc1": "Wenn Sie diese Berechtigungen in einem öffentlichen Repository speichern möchten, müssen Sie sie mit einen geheimen Schlüsselausdruck verschlüsseln.",
- "desc2": "Die Datei mit den Flow-Berechtigungen ist derzeit nicht verschlüsselt.",
+ "setup": "Einrichtung der Verschlüsselung Ihrer Datei mit den Credentials",
+ "desc0": "Die Datei mit den Flow-Credentials kann verschlüsselt werden, um ihren Inhalt zu schützen.",
+ "desc1": "Wenn Sie diese Credentials in einem öffentlichen Repository speichern möchten, müssen Sie sie mit einen geheimen Schlüsselausdruck verschlüsseln.",
+ "desc2": "Die Datei mit den Flow-Credentials ist derzeit nicht verschlüsselt.",
"desc3": "D.h. ihr Inhalt (z.B. Passwörter und Zugriffs-Tokens) kann von jedem mit Zugriff auf die Datei gelesen werden.",
- "desc4": "Wenn Sie diese Berechtigungen in einen öffentlichen Repository speichern möchten, müssen Sie diese verschlüsseln, indem Sie einen geheimen Schlüsselausdruck eingeben.",
- "desc5": "Ihre Datei mit den Flow-Berechtigungen wird derzeit mit dem Eintrag 'credentialSecret' Ihrer Einstellungsdatei als Schlüssel verschlüsselt.",
- "desc6": "Die Datei mit den Flow-Berechtigungen wird derzeit mit einem vom System generierten Schlüssel verschlüsselt. Sie sollten einen neuen geheimen Schlüssel für dieses Projekt vorgeben.",
+ "desc4": "Wenn Sie diese Credentials in einen öffentlichen Repository speichern möchten, müssen Sie diese verschlüsseln, indem Sie einen geheimen Schlüsselausdruck eingeben.",
+ "desc5": "Ihre Datei mit den Flow-Credentials wird derzeit mit dem Eintrag 'credentialSecret' Ihrer Einstellungsdatei als Schlüssel verschlüsselt.",
+ "desc6": "Die Datei mit den Flow-Credentials wird derzeit mit einem vom System generierten Schlüssel verschlüsselt. Sie sollten einen neuen geheimen Schlüssel für dieses Projekt vorgeben.",
"desc7": "Der Schlüssel wird separat von den Projektdateien gespeichert. Sie müssen den Schlüssel angeben, damit dieses Projekt auch in einem anderen Node-RED-System verwendet werden kann.",
- "credentials": "Berechtigung",
+ "credentials": "Credentials",
"enable": "Verschlüsselung aktivieren",
"disable": "Verschlüsselung deaktivieren",
"disabled": "deaktiviert",
"copy": "Vorhandenen Schlüssel ersetzen",
"use-custom": "Eigenen Schlüssel verwenden",
- "desc8": "Die Datei mit den Berechtigungen wird nicht verschlüsselt, und ihr Inhalt kann leicht gelesen werden",
+ "desc8": "Die Datei mit den Credentials wird nicht verschlüsselt und ihr Inhalt kann leicht gelesen werden",
"create-project-files": "Projektdateien erstellen",
"create-project": "Projekt erstellen",
"already-exists": "bereits vorhanden",
@@ -1083,12 +1093,12 @@
"desc": "Beschreibung",
"opt": "Optional",
"flow-file": "Flow-Datei",
- "credentials": "Berechtigungen",
+ "credentials": "Credentials",
"enable-encryption": "Verschlüsselung aktivieren",
"disable-encryption": "Verschlüsselung deaktivieren",
"encryption-key": "Schlüssel",
- "desc0": "Eine Floskel, mit der Sie Ihre Berechtigungen schützen",
- "desc1": "Die Datei mit den Berechtigungen wird nicht verschlüsselt, und ihr Inhalt kann leicht gelesen werden",
+ "desc0": "Eine Ausdruck, mit der Sie Ihre Credentials schützen",
+ "desc1": "Die Datei mit den Credentials wird nicht verschlüsselt und ihr Inhalt kann leicht gelesen werden",
"git-url": "Git-Repository-URL",
"protocols": "https://, ssh:// oder file://",
"auth-failed": "Authentifizierung fehlgeschlagen",
@@ -1098,7 +1108,7 @@
"passphrase": "Passphrase",
"desc2": "Bevor Sie ein Repository über SSH klonen können, müssen Sie einen SSH-Schlüssel hinzufügen, um auf diesen zu zugreifen",
"add-ssh-key": "Einen SSH-Schlüssel hinzufügen",
- "credentials-encryption-key": "Schlüssel für Berechtigungen",
+ "credentials-encryption-key": "Schlüssel für Credentials",
"already-exists-2": "bereits vorhanden",
"git-error": "Git-Fehler",
"con-failed": "Verbindung fehlgeschlagen",
@@ -1156,7 +1166,8 @@
"tourGuide": {
"takeATour": "Tour starten",
"start": "Start",
- "next": "Nächste"
+ "next": "Nächste",
+ "welcomeTours": "Welcome Tours"
},
"diagnostics": {
"title": "System-Informationen"
@@ -1164,8 +1175,10 @@
"languages": {
"de": "Deutsch",
"en-US": "Englisch",
+ "fr": "Französisch",
"ja": "Japanisch",
"ko": "Koreanisch",
+ "pt-BR":"Portugiesisch",
"ru": "Russisch",
"zh-CN": "Chinesisch (Vereinfacht)",
"zh-TW": "Chinesisch (Traditionell)"
diff --git a/packages/node_modules/@node-red/editor-client/locales/de/infotips.json b/packages/node_modules/@node-red/editor-client/locales/de/infotips.json
old mode 100755
new mode 100644
diff --git a/packages/node_modules/@node-red/editor-client/locales/de/jsonata.json b/packages/node_modules/@node-red/editor-client/locales/de/jsonata.json
old mode 100755
new mode 100644
diff --git a/packages/node_modules/@node-red/editor-client/locales/en-US/editor.json b/packages/node_modules/@node-red/editor-client/locales/en-US/editor.json
old mode 100755
new mode 100644
index c8abada3e..a5fad8443
--- a/packages/node_modules/@node-red/editor-client/locales/en-US/editor.json
+++ b/packages/node_modules/@node-red/editor-client/locales/en-US/editor.json
@@ -23,7 +23,11 @@
"position": "Position",
"enable": "Enable",
"disable": "Disable",
- "upload": "Upload"
+ "upload": "Upload",
+ "lock": "Lock",
+ "unlock": "Unlock",
+ "locked": "Locked",
+ "unlocked": "Unlocked"
},
"type": {
"string": "string",
@@ -53,22 +57,30 @@
"confirmDelete": "Confirm delete",
"delete": "Are you sure you want to delete '__label__'?",
"dropFlowHere": "Drop the flow here",
+ "dropImageHere": "Drop the image here",
"addFlow": "Add flow",
"addFlowToRight": "Add flow to the right",
+ "closeFlow": "Close flow",
"hideFlow": "Hide flow",
"hideOtherFlows": "Hide other flows",
- "showAllFlows": "Show all flows",
+ "showAllFlows": "Show all flows (__count__ hidden)",
"hideAllFlows": "Hide all flows",
"hiddenFlows": "List __count__ hidden flow",
"hiddenFlows_plural": "List __count__ hidden flows",
- "showLastHiddenFlow": "Show last hidden flow",
+ "showLastHiddenFlow": "Reopen hidden flow",
"listFlows": "List flows",
"listSubflows": "List subflows",
"status": "Status",
"enabled": "Enabled",
"disabled": "Disabled",
"info": "Description",
- "selectNodes": "Click nodes to select"
+ "selectNodes": "Click nodes to select",
+ "enableFlow": "Enable flow",
+ "disableFlow": "Disable flow",
+ "lockFlow": "Lock flow",
+ "unlockFlow": "Unlock flow",
+ "moveToStart": "Move flow to start",
+ "moveToEnd": "Move flow to end"
},
"menu": {
"label": {
@@ -101,6 +113,7 @@
"displayStatus": "Show node status",
"displayConfig": "Configuration nodes",
"import": "Import",
+ "importExample": "Import Example Flow",
"export": "Export",
"search": "Search flows",
"searchInput": "search your flows",
@@ -497,6 +510,7 @@
"addRemoveNode": "Add/remove node from selection",
"editSelected": "Edit selected node",
"deleteSelected": "Delete selected nodes or link",
+ "deleteReconnect": "Delete and Reconnect",
"importNode": "Import nodes",
"exportNode": "Export nodes",
"nudgeNode": "Move selected nodes (1px)",
@@ -683,7 +697,11 @@
"empty": "empty",
"globalConfig": "Global Configuration Nodes",
"triggerAction": "Trigger action",
- "find": "Find in workspace"
+ "find": "Find in workspace",
+ "copyItemUrl": "Copy item url",
+ "copyURL2Clipboard": "Copied url to clipboard",
+ "showFlow": "Show",
+ "hideFlow": "Hide"
},
"help": {
"name": "Help",
@@ -936,6 +954,9 @@
"invalid-expr": "Invalid JSONata expression:\n __message__",
"invalid-msg": "Invalid example JSON message:\n __message__",
"context-unsupported": "Cannot test context functions\n $flowContext or $globalContext",
+ "env-unsupported": "Cannot test $env function",
+ "moment-unsupported": "Cannot test $moment function",
+ "clone-unsupported": "Cannot test $clone function",
"eval": "Error evaluating expression:\n __message__"
}
},
@@ -981,7 +1002,10 @@
"quote": "Quote",
"link": "Link",
"horizontal-rule": "Horizontal rule",
- "toggle-preview": "Toggle preview"
+ "toggle-preview": "Toggle preview",
+ "mermaid": {
+ "summary": "Mermaid Diagram"
+ }
},
"bufferEditor": {
"title": "Buffer editor",
@@ -1176,8 +1200,10 @@
"languages": {
"de": "German",
"en-US": "English",
+ "fr": "French",
"ja": "Japanese",
"ko": "Korean",
+ "pt-BR":"Portuguese",
"ru": "Russian",
"zh-CN": "Chinese(Simplified)",
"zh-TW": "Chinese(Traditional)"
@@ -1203,5 +1229,10 @@
"node": "Node",
"junction": "Junction",
"linkNodes": "Link Nodes"
+ },
+ "env-var": {
+ "environment": "Environment",
+ "header": "Global Environment Variables",
+ "revert": "Revert"
}
}
diff --git a/packages/node_modules/@node-red/editor-client/locales/en-US/infotips.json b/packages/node_modules/@node-red/editor-client/locales/en-US/infotips.json
old mode 100755
new mode 100644
diff --git a/packages/node_modules/@node-red/editor-client/locales/en-US/jsonata.json b/packages/node_modules/@node-red/editor-client/locales/en-US/jsonata.json
old mode 100755
new mode 100644
diff --git a/packages/node_modules/@node-red/editor-client/locales/fr/editor.json b/packages/node_modules/@node-red/editor-client/locales/fr/editor.json
new file mode 100644
index 000000000..a80c9160e
--- /dev/null
+++ b/packages/node_modules/@node-red/editor-client/locales/fr/editor.json
@@ -0,0 +1,1238 @@
+{
+ "common": {
+ "label": {
+ "name": "Nom",
+ "ok": "Ok",
+ "done": "Terminer",
+ "cancel": "Annuler",
+ "delete": "Supprimer",
+ "close": "Fermer",
+ "load": "Ouvrir",
+ "save": "Sauver",
+ "import": "Importer",
+ "export": "Exporter",
+ "back": "Retour",
+ "next": "Suivant",
+ "clone": "Cloner",
+ "cont": "Continuer",
+ "style": "Style",
+ "line": "Bordure",
+ "fill": "Remplissage",
+ "label": "Etiquette",
+ "color": "Couleur",
+ "position": "Position",
+ "enable": "Activer",
+ "disable": "Désactiver",
+ "upload": "Charger",
+ "lock": "Verrouiller",
+ "unlock": "Déverrouiller",
+ "locked": "Verrouillé",
+ "unlocked": "Déverrouillé"
+ },
+ "type": {
+ "string": "chaîne de caractères",
+ "number": "nombre",
+ "boolean": "booléen",
+ "array": "tableau",
+ "buffer": "tampon",
+ "object": "objet",
+ "jsonString": "chaîne JSON",
+ "undefined": "indéfini",
+ "null": "nul"
+ }
+ },
+ "event": {
+ "loadPlugins": "Chargement des extensions",
+ "loadPalette": "Chargement de la palette",
+ "loadNodeCatalogs": "Chargement des catalogues de noeuds",
+ "loadNodes": "Chargement des noeuds __count__",
+ "loadFlows": "Chargement des flux",
+ "importFlows": "Ajout de flux à l'espace de travail",
+ "importError": "
Erreur lors de l'ajout du flux
__message__
",
+ "loadingProject": "Chargement du projet"
+ },
+ "workspace": {
+ "defaultName": "Flux __number__",
+ "editFlow": "Modifier le flux : __name__",
+ "confirmDelete": "Confirmation de la suppression",
+ "delete": "Etes-vous sûr de vouloir supprimer '__label__'?",
+ "dropFlowHere": "Déposer le flux ici",
+ "dropImageHere": "Déposer l'image ici",
+ "addFlow": "Ajouter un flux",
+ "addFlowToRight": "Ajouter un flux à droite",
+ "closeFlow": "Fermer le flux",
+ "hideFlow": "Masquer le flux",
+ "hideOtherFlows": "Masquer les autres flux",
+ "showAllFlows": "Afficher tous les flux",
+ "hideAllFlows": "Masquer tous les flux",
+ "hiddenFlows": "Répertorier le flux masqué __count__",
+ "hiddenFlows_plural": "Répertorier les flux masqués __count__",
+ "showLastHiddenFlow": "Afficher le dernier flux masqué",
+ "listFlows": "Répertorier les flux",
+ "listSubflows": "Répertorier les sous-flux",
+ "status": "Statut",
+ "enabled": "Activé",
+ "disabled": "Désactivé",
+ "info": "Description",
+ "selectNodes": "Cliquer sur les noeuds pour sélectionner",
+ "enableFlow": "Activer le flux",
+ "disableFlow": "Désactiver le flux",
+ "lockFlow": "Verrouiller le flux",
+ "unlockFlow": "Déverrouiller le flux",
+ "moveToStart": "Déplacer le flux au début",
+ "moveToEnd": "Déplacer le flux vers la fin"
+ },
+ "menu": {
+ "label": {
+ "view": {
+ "view": "Affichage",
+ "grid": "Grille",
+ "storeZoom": "Restaurer le niveau de zoom au chargement",
+ "storePosition": "Restaurer la position de défilement au chargement",
+ "showGrid": "Afficher la grille",
+ "snapGrid": "Aligner sur la grille",
+ "gridSize": "Taille de la grille",
+ "textDir": "Sens du texte",
+ "defaultDir": "Sens par défaut",
+ "ltr": "De gauche à droite",
+ "rtl": "De droite à gauche",
+ "auto": "Contextuel",
+ "language": "Langue",
+ "browserDefault": "Navigateur par défaut"
+ },
+ "sidebar": {
+ "show": "Afficher la barre latérale"
+ },
+ "palette": {
+ "show": "Afficher la palette"
+ },
+ "edit": "Éditer",
+ "settings": "Paramètres",
+ "userSettings": "Paramètres de l'utilisateur",
+ "nodes": "Noeuds",
+ "displayStatus": "Afficher l'état du noeud",
+ "displayConfig": "Noeuds de configuration",
+ "import": "Importer",
+ "importExample": "Importer un exemple de flux",
+ "export": "Exporter",
+ "search": "Rechercher les flux",
+ "searchInput": "Rechercher vos flux",
+ "subflows": "Sous-flux",
+ "createSubflow": "Créer un sous-flux",
+ "selectionToSubflow": "Selection d'un sous-flux",
+ "flows": "Flux",
+ "add": "Ajouter",
+ "rename": "Renommer",
+ "delete": "Supprimer",
+ "keyboardShortcuts": "Raccourcis clavier",
+ "login": "Se connecter",
+ "logout": "Se déconnecter",
+ "editPalette": "Gérer la palette",
+ "other": "Autre",
+ "showTips": "Afficher les astuces",
+ "showWelcomeTours": "Afficher les visites guidées pour les nouvelles versions",
+ "help": "Site web de Node-RED",
+ "projects": "Projets",
+ "projects-new": "Nouveau projet",
+ "projects-open": "Ouvrir le projet",
+ "projects-settings": "Paramètres du projet",
+ "showNodeLabelDefault": "Afficher l'étiquette des noeuds nouvellement ajoutés",
+ "codeEditor": "Éditeur de code",
+ "groups": "Groupes",
+ "groupSelection": "Grouper cette sélection",
+ "ungroupSelection": "Dégrouper la sélection",
+ "groupMergeSelection": "Fusionner la sélection",
+ "groupRemoveSelection": "Supprimer du groupe",
+ "arrange": "Organiser",
+ "alignLeft": "Aligner à gauche",
+ "alignCenter": "Aligner au centre",
+ "alignRight": "Aligner à droite",
+ "alignTop": "Aligner en haut",
+ "alignMiddle": "Aligner au milieu",
+ "alignBottom": "Aligner en bas",
+ "distributeHorizontally": "Répartir horizontalement",
+ "distributeVertically": "Distribuer verticalement",
+ "moveToBack": "Déplacer vers l'arrière",
+ "moveToFront": "Déplacer vers l'avant",
+ "moveBackwards": "Reculer",
+ "moveForwards": "Avancer"
+ }
+ },
+ "actions": {
+ "toggle-navigator": "Basculer de navigateur",
+ "zoom-out": "Dézoomer",
+ "zoom-reset": "Réinitialiser le zoom",
+ "zoom-in": "Agrandir",
+ "search-flows": "Rechercher le flux",
+ "search-prev": "Précédent",
+ "search-next": "Suivant",
+ "search-counter": "\"__term__\" __result__ de __count__"
+ },
+ "user": {
+ "loggedInAs": "Connecté en tant que __name__",
+ "username": "Nom d'utilisateur",
+ "password": "Mot de passe",
+ "login": "Connexion",
+ "loginFailed": "Échec de la connexion",
+ "notAuthorized": "Pas autorisé",
+ "errors": {
+ "settings": "Vous devez être connecté pour accéder aux paramètres",
+ "deploy": "Vous devez être connecté pour déployer les modifications",
+ "notAuthorized": "Vous devez être connecté pour effectuer cette action"
+ }
+ },
+ "notification": {
+ "state": {
+ "flowsStopped": "Flux arrêtés",
+ "flowsStarted": "Flux démarrés"
+ },
+ "warning": "Attention : __message__",
+ "warnings": {
+ "undeployedChanges": "Le noeud a des modifications non déployées",
+ "nodeActionDisabled": "Actions de noeud désactivées",
+ "nodeActionDisabledSubflow": "Actions de noeud désactivées dans le sous-flux",
+ "missing-types": "
Flux arrêtés en raison de types de noeuds manquants.
",
+ "missing-modules": "
Flux arrêtés en raison de modules manquants.
",
+ "safe-mode": "
Flux arrêtés en mode sans échec.
Vous pouvez modifier vos flux et déployer les changements pour redémarrer.
",
+ "restartRequired": "Node-RED doit être redémarré pour mettre à jour les modules",
+ "credentials_load_failed": "
Les flux se sont arrêtés car les informations d'identification n'ont pas pu être déchiffrées.
Le fichier d'informations d'identification du flux est chiffré, mais la clé de chiffrement du projet est manquante ou invalide.
",
+ "credentials_load_failed_reset": "
Les informations d'identification n'ont pas pu être déchiffrées
Le fichier d'informations d'identification du flux est chiffré, mais la clé de chiffrement du projet est manquante ou invalide.
Le fichier d'informations d'identification du flux sera réinitialisé lors du prochain déploiement. Toutes les informations d'identification de flux existantes seront perdues.
",
+ "missing_flow_file": "
Fichier contenant les flux introuvable.
Le projet n'est pas configuré avec un fichier de flux.
",
+ "missing_package_file": "
Fichier de paquetage du projet introuvable.
Il manque au projet un fichier package.json.
",
+ "project_empty": "
Le projet est vide.
Voulez-vous créer un ensemble de fichiers de projet par défaut ? Sinon, vous devrez ajouter manuellement des fichiers au projet (en dehors de l'éditeur).
",
+ "project_not_found": "
Le projet '__project__' est introuvable.
",
+ "git_merge_conflict": "
La fusion automatique des modifications a échoué.
Corriger les conflits non fusionnés, puis valider le résultat.
"
+ },
+ "error": "Erreur : __message__",
+ "errors": {
+ "lostConnection": "Connexion avec le serveur perdue, reconnexion...",
+ "lostConnectionReconnect": "Connexion avec le serveur perdue, reconnexion dans __time__s.",
+ "lostConnectionTry": "Essayer maintenant",
+ "cannotAddSubflowToItself": "Impossible d'ajouter un sous-flux à lui-même",
+ "cannotAddCircularReference": "Impossible d'ajouter un sous-flux - référence circulaire détectée",
+ "unsupportedVersion": "
Utilisation d'une version non prise en charge de Node.js
Vous devez effectuer une mise à jour vers la dernière version de Node.js LTS
",
+ "failedToAppendNode": "
Échec du chargement du module '__module__'
__error__
"
+ },
+ "project": {
+ "change-branch": "Changer pour une branche locale '__project__'",
+ "merge-abort": "Git fusion abandonnée",
+ "loaded": "Projet '__project__' chargé",
+ "updated": "Projet '__project__' mis à jour",
+ "pull": "Projet '__project__' rechargé",
+ "revert": "Projet '__project__' annulé",
+ "merge-complete": "Fusion Git terminée",
+ "setupCredentials": "Configuration des identifiants",
+ "setupProjectFiles": "Configuration des fichiers du projet",
+ "no": "Non merci",
+ "createDefault": "Créer des fichiers de projet par défaut",
+ "mergeConflict": "Afficher les conflits de fusion"
+ },
+ "label": {
+ "manage-project-dep": "Gérer les dépendances du projet",
+ "setup-cred": "Configuration des identifiants",
+ "setup-project": "Configuration des fichiers du projet",
+ "create-default-package": "Créer un fichier de paquetage par défaut",
+ "no-thanks": "Non merci",
+ "create-default-project": "Créer des fichiers de projet par défaut",
+ "show-merge-conflicts": "Afficher les conflits de fusion",
+ "unknownNodesButton": "Rechercher les noeuds inconnus"
+ }
+ },
+ "clipboard": {
+ "clipboard": "Presse-papiers",
+ "nodes": "Noeuds",
+ "node": "__count__ noeud",
+ "node_plural": "__count__ noeuds",
+ "configNode": "__count__ noeud de configuration",
+ "configNode_plural": "__count__ noeuds de configuration",
+ "group": "__count__ groupe",
+ "group_plural": "__count__ groupes",
+ "flow": "__count__ flux",
+ "flow_plural": "__count__ flux",
+ "subflow": "__count__ sous-flux",
+ "subflow_plural": "__count__ sous-flux",
+ "replacedNodes": "__count__ noeud remplacé",
+ "replacedNodes_plural": "__count__ noeuds remplacés",
+ "pasteNodes": "Coller le flux JSON ou",
+ "selectFile": "Sélectionner un fichier à importer",
+ "importNodes": "Importer des noeuds",
+ "exportNodes": "Exporter des noeuds",
+ "download": "Télécharger",
+ "importUnrecognised": "Importation d'un type inconnu :",
+ "importUnrecognised_plural": "Importation de plusieurs types inconnus :",
+ "importDuplicate": "Noeud en double importé :",
+ "importDuplicate_plural": "Noeuds en double importés :",
+ "nodesExported": "Noeuds exportés vers le presse-papiers",
+ "nodesImported": "Noeuds importés :",
+ "nodeCopied": "__count__ noeud copié",
+ "nodeCopied_plural": "__count__ noeuds copiés",
+ "groupCopied": "__count__ groupe copié",
+ "groupCopied_plural": "__count__ groupes copiés",
+ "groupStyleCopied": "Style de groupe copié",
+ "invalidFlow": "Flux invalide : __message__",
+ "recoveredNodes": "Noeuds récupérés",
+ "recoveredNodesInfo": "Les noeuds importés sur ce flux contiennent un mauvais identifiant de flux. Ces noeuds ont été ajoutés à ce flux afin que vous puissiez les restaurer ou les supprimer.",
+ "recoveredNodesNotification": "
Noeuds importés sans identifiant de flux valide
Ils ont été ajoutés à un nouveau flux appelé '__flowName__'.
",
+ "export": {
+ "selected": "noeuds sélectionnés",
+ "current": "flux actuel",
+ "all": "tous les flux",
+ "compact": "condensé",
+ "formatted": "formaté",
+ "copy": "Copier dans le presse-papier",
+ "export": "Exporter vers la bibliothèque",
+ "exportAs": "Exporter en tant que",
+ "overwrite": "Remplacer",
+ "exists": "
\"__file__\" existe déjà.
Voulez-vous le remplacer ?
"
+ },
+ "import": {
+ "import": "Importer vers",
+ "importSelected": "Importation sélectionnée",
+ "importCopy": "Importer une copie",
+ "viewNodes": "Afficher les noeuds...",
+ "newFlow": "Nouveau flux",
+ "replace": "Remplacer",
+ "errors": {
+ "notArray": "L'entrée n'est pas un tableau JSON",
+ "itemNotObject": "L'entrée n'est pas un flux valide - l'élément '__index__' n'est pas un objet du noeud",
+ "missingId": "L'entrée n'est pas un flux valide - l'élément '__index__' n'a pas de propriété 'id'",
+ "missingType": "L'entrée n'est pas un flux valide - l'élément '__index__' n'a pas de propriété 'type'"
+ },
+ "conflictNotification1": "Certains des noeuds que vous avez importés existent déjà dans votre espace de travail.",
+ "conflictNotification2": "Sélectionner les noeuds à importer et choisir s'il faut remplacer les noeuds existants ou en importer une copie."
+ },
+ "copyMessagePath": "Chemin copié",
+ "copyMessageValue": "Valeur copiée",
+ "copyMessageValue_truncated": "Valeur tronquée (coupée) copiée"
+ },
+ "deploy": {
+ "deploy": "Déployer",
+ "full": "Tout",
+ "fullDesc": "Déploie tout l'espace de travail",
+ "modifiedFlows": "Flux modifiés",
+ "modifiedFlowsDesc": "Déploie uniquement les flux contenant des noeuds modifiés",
+ "modifiedNodes": "Noeuds modifiés",
+ "modifiedNodesDesc": "Déploie uniquement les noeuds qui ont changés",
+ "startFlows": "Démarrer",
+ "startFlowsDesc": "Démarrer les flux",
+ "stopFlows": "Arrêter",
+ "stopFlowsDesc": "Arrêter les flux",
+ "restartFlows": "Redémarrer les flux",
+ "restartFlowsDesc": "Redémarrer les flux actuellement déployés",
+ "successfulDeploy": "Déployé avec succès",
+ "successfulRestart": "Flux redémarrés avec succès",
+ "deployFailed": "Échec du déploiement : __message__",
+ "unusedConfigNodes": "Vous avez des noeuds de configuration inutilisés.",
+ "unusedConfigNodesButton": "Rechercher les noeuds de configuration inutilisés",
+ "unknownNodesButton": "Rechercher les noeuds inconnus",
+ "invalidNodesButton": "Rechercher les noeuds invalides",
+ "errors": {
+ "noResponse": "Pas de réponse du serveur"
+ },
+ "confirm": {
+ "button": {
+ "ignore": "Ignorer",
+ "confirm": "Confirmer",
+ "review": "Examiner les modifications",
+ "cancel": "Annuler",
+ "merge": "Fusionner",
+ "overwrite": "Ignorer et déployer"
+ },
+ "undeployedChanges": "Vous avez des modifications non déployées.\n\nSi vous quittez cette page, ces modifications seront perdues.",
+ "improperlyConfigured": "L'espace de travail contient des noeuds qui ne sont pas correctement configurés :",
+ "unknown": "L'espace de travail contient des types de noeuds inconnus :",
+ "confirm": "Êtes-vous sûr de vouloir déployer ?",
+ "doNotWarn": "Ne plus m'avertir à ce sujet",
+ "conflict": "Le serveur exécute un ensemble de flux plus récent.",
+ "backgroundUpdate": "Les flux sur le serveur ont été mis à jour.",
+ "conflictChecking": "Vérifier si les modifications peuvent être fusionnées automatiquement",
+ "conflictAutoMerge": "Les modifications n'incluent aucun conflit et peuvent être fusionnées automatiquement.",
+ "conflictManualMerge": "Les changements incluent des conflits qui doivent être résolus avant de pouvoir être déployés.",
+ "plusNMore": "+ __count__ en plus"
+ }
+ },
+ "eventLog": {
+ "title": "Journal des événements",
+ "view": "Afficher le journal"
+ },
+ "diff": {
+ "unresolvedCount": "__count__ conflit non résolu",
+ "unresolvedCount_plural": "__count__ conflits non résolus",
+ "globalNodes": "noeuds globaux",
+ "flowProperties": "Propriétés du flux",
+ "type": {
+ "added": "ajouté",
+ "changed": "modifié",
+ "unchanged": "inchangé",
+ "deleted": "supprimé",
+ "flowDeleted": "flux supprimé",
+ "flowAdded": "flux ajouté",
+ "movedTo": "déplacé vers __id__",
+ "movedFrom": "déplacé depuis __id__"
+ },
+ "nodeCount": "__count__ noeud",
+ "nodeCount_plural": "__count__ noeuds",
+ "local": "Changements locaux",
+ "remote": "Modifications à distance",
+ "reviewChanges": "Examiner les modifications",
+ "noBinaryFileShowed": "Impossible d'afficher le contenu du fichier binaire",
+ "viewCommitDiff": "Afficher les modifications de validation",
+ "compareChanges": "Comparer les modifications",
+ "saveConflict": "Enregistrer la résolution des conflits",
+ "conflictHeader": "__resolved__ sur __unresolved__ conflit(s) résolu(s)",
+ "commonVersionError": "La version commune ne contient pas de JSON valide :",
+ "oldVersionError": "L'ancienne version ne contient pas de JSON valide :",
+ "newVersionError": "La nouvelle version ne contient pas de JSON valide :"
+ },
+ "subflow": {
+ "editSubflowInstance": "Modifier l'instance du sous-flux : __name__",
+ "editSubflow": "Modifier le modèle du sous-flux : __name__",
+ "edit": "Modifier le modèle du sous-flux",
+ "subflowInstances": "Il existe __count__ instance de ce modèle de sous-flux",
+ "subflowInstances_plural": "Il existe __count__ instances de ce modèle de sous-flux",
+ "editSubflowProperties": "modifier les propriétés",
+ "input": "entrées:",
+ "output": "sorties:",
+ "status": "statut du noeud",
+ "deleteSubflow": "supprimer le sous-flux",
+ "confirmDelete": "Voulez-vous vraiment supprimer ce sous-flux ?",
+ "info": "Description",
+ "category": "Catégorie",
+ "module": "Module",
+ "license": "Licence",
+ "licenseNone": "Aucune",
+ "licenseOther": "Autre",
+ "type": "Type de noeud",
+ "version": "Version",
+ "versionPlaceholder": "x.y.z",
+ "keys": "Mots clés",
+ "keysPlaceholder": "Mots clés séparés par des virgules",
+ "author": "Auteur",
+ "authorPlaceholder": "Votre nom ",
+ "desc": "Description",
+ "env": {
+ "restore": "Restaurer le sous-flux par défaut",
+ "remove": "Supprimer la variable d'environnement"
+ },
+ "errors": {
+ "noNodesSelected": "Impossible de créer un sous-flux : aucun noeud sélectionné",
+ "multipleInputsToSelection": "Impossible de créer un sous-flux : plusieurs entrées pour la sélection"
+ }
+ },
+ "group": {
+ "editGroup": "Modifier le groupe : __name__",
+ "errors": {
+ "cannotCreateDiffGroups": "Impossible de créer un groupe de noeuds provenant de différents groupes",
+ "cannotAddSubflowPorts": "Impossible d'ajouter des ports à un groupe de sous-flux"
+ }
+ },
+ "editor": {
+ "configEdit": "Modifier",
+ "configAdd": "Ajouter",
+ "configUpdate": "Sauver",
+ "configDelete": "Supprimer",
+ "nodesUse": "__count__ noeud utilise cette configuration",
+ "nodesUse_plural": "__count__ noeuds utilisent cette configuration",
+ "addNewConfig": "Ajouter un nouveau noeud de configuration __type__",
+ "editNode": "Modifier le noeud __type__",
+ "editConfig": "Modifier le noeud de configuration __type__",
+ "addNewType": "Ajouter un nouveau __type__...",
+ "nodeProperties": "Propriétés du noeud",
+ "label": "Étiquette",
+ "color": "Couleur",
+ "portLabels": "Étiquettes des ports",
+ "labelInputs": "Entrées",
+ "labelOutputs": "Sorties",
+ "settingIcon": "Icône",
+ "default": "Par défaut",
+ "noDefaultLabel": "Aucune",
+ "defaultLabel": "Utiliser l'étiquette par défaut",
+ "searchIcons": "Icônes de recherche",
+ "useDefault": "Utilisation par défaut",
+ "description": "Description",
+ "show": "Afficher",
+ "hide": "Masquer",
+ "locale": "Sélectionner la langue",
+ "icon": "Icône",
+ "inputType": "Type d'entrée",
+ "selectType": "Sélectionner les types...",
+ "loadCredentials": "Chargement des identifiants du noeud",
+ "inputs": {
+ "input": "entrée",
+ "select": "sélection",
+ "checkbox": "case à cocher",
+ "spinner": "valeurs à défiler",
+ "none": "aucune",
+ "hidden": "masquer la propriété"
+ },
+ "types": {
+ "str": "chaîne de caractères",
+ "num": "nombre",
+ "bool": "booléen",
+ "json": "JSON",
+ "bin": "tampon",
+ "env": "variable d'environnement",
+ "cred": "identifiant"
+ },
+ "menu": {
+ "input": "entrée",
+ "select": "sélection",
+ "checkbox": "case à cocher",
+ "spinner": "valeurs à défiler",
+ "hidden": "étiquette seulement"
+ },
+ "select": {
+ "label": "Etiquette",
+ "value": "Valeur"
+ },
+ "spinner": {
+ "min": "Minimum",
+ "max": "Maximum"
+ },
+ "errors": {
+ "scopeChange": "La modification de la portée la rendra indisponible pour les noeuds d'autres flux qui l'utilisent",
+ "invalidProperties": "Propriétés invalides :",
+ "credentialLoadFailed": "Échec du chargement des identifiants du noeud"
+ }
+ },
+ "keyboard": {
+ "title": "Raccourcis clavier",
+ "keyboard": "Clavier",
+ "filterActions": "Actions de filtrage",
+ "shortcut": "raccourci",
+ "scope": "portée",
+ "unassigned": "Non attribué",
+ "global": "global",
+ "workspace": "espace de travail",
+ "selectAll": "Tout sélectionner",
+ "selectNone": "Ne rien sélectionner",
+ "selectAllConnected": "Sélectionner tous les éléments connectés",
+ "addRemoveNode": "Ajouter/supprimer un noeud de la sélection",
+ "editSelected": "Modifier le noeud sélectionné",
+ "deleteSelected": "Supprimer les noeuds ou le lien sélectionné(s)",
+ "deleteReconnect": "Supprimer et reconnecter",
+ "importNode": "Importer les noeuds",
+ "exportNode": "Exporter les noeuds",
+ "nudgeNode": "Déplacer les noeuds sélectionnés (1px)",
+ "moveNode": "Déplacer les noeuds sélectionnés (20px)",
+ "toggleSidebar": "Basculer la barre latérale",
+ "togglePalette": "Basculer la palette",
+ "copyNode": "Copier les noeuds sélectionnés",
+ "cutNode": "Couper les noeuds sélectionnés",
+ "pasteNode": "Coller les noeuds",
+ "copyGroupStyle": "Copier le style de groupe",
+ "pasteGroupStyle": "Coller le style de groupe",
+ "undoChange": "Annuler",
+ "redoChange": "Rétablir",
+ "searchBox": "Ouvrir le champ de recherche",
+ "managePalette": "Gérer la palette",
+ "actionList": "Liste d'action",
+ "splitWireWithLinks": "Ajouter des liens à la sélection"
+ },
+ "library": {
+ "library": "Bibliothèque",
+ "openLibrary": "Ouvrir la bibliothèque...",
+ "saveToLibrary": "Enregistrer dans la bibliothèque...",
+ "typeLibrary": "__type__ bibliothèque",
+ "unnamedType": "Innomé __type__",
+ "exportedToLibrary": "Noeuds exportés vers la bibliothèque",
+ "dialogSaveOverwrite": "Une __libraryType__ appelée __libraryName__ existe déjà. Écraser ?",
+ "invalidFilename": "Nom de fichier non valide",
+ "savedNodes": "Noeuds enregistrés",
+ "savedType": "__type__ enregistré",
+ "saveFailed": "Échec de la sauvegarde : __message__",
+ "newFolder": "Nouveau dossier",
+ "types": {
+ "local": "Local",
+ "examples": "Exemples"
+ }
+ },
+ "palette": {
+ "noInfo": "Pas d'information disponible",
+ "filter": "Filtrer les noeuds",
+ "search": "Rechercher les modules",
+ "addCategory": "Ajouter un nouveau...",
+ "label": {
+ "subflows": "sous-flux",
+ "network": "réseau",
+ "common": "commun",
+ "input": "entrée",
+ "output": "sortie",
+ "function": "fonction",
+ "sequence": "séquence",
+ "parser": "analyseur",
+ "social": "social",
+ "storage": "stockage",
+ "analysis": "analyse",
+ "advanced": "avancé"
+ },
+ "actions": {
+ "collapse-all": "Réduire toutes les catégories",
+ "expand-all": "Développer toutes les catégories"
+ },
+ "event": {
+ "nodeAdded": "Noeud ajouté à la palette :",
+ "nodeAdded_plural": "Noeuds ajoutés à la palette :",
+ "nodeRemoved": "Noeud supprimé de la palette :",
+ "nodeRemoved_plural": "Noeuds supprimés de la palette :",
+ "nodeEnabled": "Noeud activé :",
+ "nodeEnabled_plural": "Noeuds activés :",
+ "nodeDisabled": "Noeud désactivé :",
+ "nodeDisabled_plural": "Noeuds désactivés :",
+ "nodeUpgraded": "Les noeuds du module __module__ ont été mis à jour vers la version __version__",
+ "unknownNodeRegistered": "Erreur lors du chargement du noeud :
__type__ __error__
"
+ },
+ "editor": {
+ "title": "Gérer la palette",
+ "palette": "Palette",
+ "times": {
+ "seconds": "il y a quelques secondes",
+ "minutes": "il y a quelques minutes",
+ "minutesV": "il y a __count__ minutes",
+ "hoursV": "il y a __count__ heure",
+ "hoursV_plural": "il y a __count__ heures",
+ "daysV": "il y a __count__ jour",
+ "daysV_plural": "il y a __count__ jours",
+ "weeksV": "il y a __count__ semaine",
+ "weeksV_plural": "il y a __count__ semaines",
+ "monthsV": "il y a __count__ mois",
+ "monthsV_plural": "il y a __count__ mois",
+ "yearsV": "il y a __count__ an",
+ "yearsV_plural": "il y a __count__ ans",
+ "yearMonthsV": "il y a __y__ an, __count__ mois",
+ "yearMonthsV_plural": "il y a __y__ an, __count__ mois",
+ "yearsMonthsV": "il y a __y__ ans, __count__ mois",
+ "yearsMonthsV_plural": "il y a __y__ ans, __count__ mois"
+ },
+ "nodeCount": "__label__ noeud",
+ "nodeCount_plural": "__label__ noeuds",
+ "moduleCount": "__count__ module disponible",
+ "moduleCount_plural": "__count__ modules disponibles",
+ "inuse": "en cours d'utilisation",
+ "enableall": "activer tout",
+ "disableall": "désactiver tout",
+ "enable": "activer",
+ "disable": "désactiver",
+ "remove": "supprimer",
+ "update": "mettre à jour vers __version__",
+ "updated": "mis à jour",
+ "install": "installer",
+ "installed": "installé",
+ "conflict": "conflit",
+ "conflictTip": "
Ce module ne peut pas être installé car il inclut un type de noeud qui a déjà été installé
Conflits avec __module__
",
+ "loading": "Chargement des catalogues...",
+ "tab-nodes": "Noeuds",
+ "tab-install": "Installer",
+ "sort": "trier:",
+ "sortAZ": "a-z",
+ "sortRecent": "récent",
+ "more": "+ __count__ en plus",
+ "upload": "Charger le fichier tgz du module",
+ "refresh": "Actualiser la liste des modules",
+ "errors": {
+ "catalogLoadFailed": "
Échec du chargement du catalogue de noeuds.
Vérifier la console du navigateur pour plus d'informations
",
+ "installFailed": "
Échec lors de l'installation : __module__
__message__
Consulter le journal pour plus d'informations
",
+ "removeFailed": "
Échec lors de la suppression : __module__
__message__
Consulter le journal pour plus d'informations
",
+ "updateFailed": "
Échec lors de la mise à jour : __module__
__message__
Consulter le journal pour plus d'informations
",
+ "enableFailed": "
Échec lors de l'activation : __module__
__message__
Consulter le journal pour plus d'informations
",
+ "disableFailed": "
Échec lors de la désactivation : __module__
__message__
Consulter le journal pour plus d'informations
"
+ },
+ "confirm": {
+ "install": {
+ "body": "
Installation de '__module__'
Avant l'installation, veuiller lire la documentation du noeud. Certains noeuds ont des dépendances qui ne peuvent pas être résolues automatiquement et peuvent nécessiter un redémarrage de Node-RED.
La mise à jour du noeud nécessitera un redémarrage de Node-RED pour terminer la mise à jour. Cela doit être fait manuellement.
",
+ "title": "Mettre à jour les noeuds"
+ },
+ "cannotUpdate": {
+ "body": "Une mise à jour pour ce noeud est disponible, mais il n'est pas installé dans un emplacement que le gestionnaire de palette peut mettre à jour.
Veuiller vous référer à la documentation pour savoir comment mettre à jour ce noeud."
+ },
+ "button": {
+ "review": "Ouvrir la documentation",
+ "install": "Installer",
+ "remove": "Supprimer",
+ "update": "Mettre à jour"
+ }
+ }
+ }
+ },
+ "sidebar": {
+ "info": {
+ "name": "Information",
+ "tabName": "Nom",
+ "label": "info",
+ "node": "Noeud",
+ "type": "Type",
+ "group": "Groupe",
+ "module": "Module",
+ "id": "ID (identifiant)",
+ "status": "Statut",
+ "enabled": "Activé",
+ "disabled": "Désactivé",
+ "subflow": "Sous-flux",
+ "instances": "Instances",
+ "properties": "Propriétés",
+ "info": "Information",
+ "desc": "Description",
+ "blank": "vide",
+ "null": "nul",
+ "showMore": "afficher en plus",
+ "showLess": "afficher en moins",
+ "flow": "Flux",
+ "selection": "Sélection",
+ "nodes": "__count__ noeuds",
+ "flowDesc": "Description du flux",
+ "subflowDesc": "Description du sous-flux",
+ "nodeHelp": "Aide sur les noeuds",
+ "none": "Aucun",
+ "arrayItems": "__count__ éléments",
+ "showTips": "Vous pouvez ouvrir les astuces à partir du panneau des paramètres",
+ "outline": "Plan",
+ "empty": "vide",
+ "globalConfig": "Noeuds de configuration globale",
+ "triggerAction": "Déclencher une action",
+ "find": "Rechercher dans l'espace de travail",
+ "copyItemUrl": "Copier l'URL de l'élément",
+ "copyURL2Clipboard": "URL copiée dans le presse-papiers",
+ "showFlow": "Afficher",
+ "hideFlow": "Masquer"
+ },
+ "help": {
+ "name": "Aide",
+ "label": "aide",
+ "search": "Aide à la recherche",
+ "nodeHelp": "Aide sur les noeuds",
+ "showHelp": "Afficher l'aide",
+ "showInOutline": "Afficher dans les grandes lignes",
+ "showTopics": "Afficher les sujets",
+ "noHelp": "Aucune rubrique d'aide sélectionnée",
+ "changeLog": "Journal des modifications"
+ },
+ "config": {
+ "name": "Noeuds de configuration",
+ "label": "configuration",
+ "global": "Tous les flux",
+ "none": "aucun",
+ "subflows": "sous-flux",
+ "flows": "flux",
+ "filterAll": "tout",
+ "showAllConfigNodes": "Afficher tous les noeuds de configuration",
+ "filterUnused": "inutilisé",
+ "showAllUnusedConfigNodes": "Afficher tous les noeuds de configuration inutilisés",
+ "filtered": "__count__ caché(s)"
+ },
+ "context": {
+ "name": "Données contextuelles",
+ "label": "contexte",
+ "none": "aucune sélection",
+ "refresh": "actualiser pour charger",
+ "empty": "vide",
+ "node": "Noeud",
+ "flow": "Flux",
+ "global": "Global",
+ "deleteConfirm": "Êtes-vous sûr de vouloir supprimer cet élément ?",
+ "autoRefresh": "Rafraîchir si la sélection change",
+ "refrsh": "Rafraîchir",
+ "delete": "Supprimer"
+ },
+ "palette": {
+ "name": "Gestion des palettes",
+ "label": "palette"
+ },
+ "project": {
+ "label": "projet",
+ "name": "Projet",
+ "description": "Description",
+ "dependencies": "Dépendances",
+ "settings": "Paramètres",
+ "noSummaryAvailable": "Aucun résumé disponible",
+ "editDescription": "Modifier la description du projet",
+ "editDependencies": "Modifier les dépendances du projet",
+ "noDescriptionAvailable": "Pas de description disponible",
+ "editReadme": "Modifier le fichier README.md",
+ "showProjectSettings": "Afficher les paramètres du projet",
+ "projectSettings": {
+ "title": "Paramètres du projet",
+ "edit": "modifier",
+ "none": "Vide",
+ "install": "installer",
+ "removeFromProject": "supprimer du projet",
+ "addToProject": "ajouter au projet",
+ "files": "Fichiers",
+ "flow": "Flux",
+ "credentials": "Identifiants",
+ "package": "Paquets",
+ "packageCreate": "Le fichier sera créé lorsque les modifications seront enregistrées",
+ "fileNotExist": "Le fichier n'existe pas",
+ "selectFile": "Choisir le dossier",
+ "invalidEncryptionKey": "Clé de chiffrement invalide",
+ "encryptionEnabled": "Chiffrement activé",
+ "encryptionDisabled": "Chiffrement désactivé",
+ "setTheEncryptionKey": "Définir la clé de chiffrement",
+ "resetTheEncryptionKey": "Réinitialiser la clé de chiffrement",
+ "changeTheEncryptionKey": "Changer la clé de chiffrement",
+ "currentKey": "Clé actuelle",
+ "newKey": "Nouvelle clé",
+ "credentialsAlert": "Cela supprimera tous les identifiants existants",
+ "versionControl": "Contrôle de version",
+ "branches": "Branches",
+ "noBranches": "Pas de branche",
+ "deleteConfirm": "Êtes-vous sûr de vouloir supprimer la branche locale '__name__' ? Ça ne peut pas être annulé.",
+ "unmergedConfirm": "La branche locale '__name__' contient des modifications non fusionnées qui seront perdues. Etes-vous sûr de vouloir la supprimer?",
+ "deleteUnmergedBranch": "Supprimer la branche non fusionnée",
+ "gitRemotes": "Git distant",
+ "addRemote": "Ajout distant",
+ "addRemote2": "Ajout distant",
+ "remoteName": "Nom distant",
+ "nameRule": "Doit contenir uniquement A-Z 0-9 _ -",
+ "url": "URL",
+ "urlRule": "https://, ssh:// ou file://",
+ "urlRule2": "Ne pas inclure le nom d'utilisateur/mot de passe dans l'URL",
+ "noRemotes": "Pas distant",
+ "deleteRemoteConfrim": "Êtes-vous sûr de vouloir supprimer '__name__' distant ?",
+ "deleteRemote": "Supprimer distant"
+ },
+ "userSettings": {
+ "committerDetail": "Détails de l'auteur de la validation (commit)",
+ "committerTip": "Laisser vide pour utiliser la valeur par défaut du système",
+ "userName": "Nom d'utilisateur",
+ "email": "e-mail",
+ "workflow": "Flux de travail",
+ "workfowTip": "Choisisser votre flux de travail Git préféré",
+ "workflowManual": "Manuel",
+ "workflowManualTip": "Toutes les modifications doivent être validées manuellement dans la barre latérale 'historique'",
+ "workflowAuto": "Automatique",
+ "workflowAutoTip": "Les modifications sont validées automatiquement à chaque déploiement",
+ "sshKeys": "Clés SSH",
+ "sshKeysTip": "Vous permet de créer des connexions sécurisées aux référentiels Git distants.",
+ "add": "ajouter une clé",
+ "addSshKey": "Ajouter une clé SSH",
+ "addSshKeyTip": "Générer une nouvelle paire de clés publique/privée",
+ "name": "Nom",
+ "nameRule": "Doit contenir uniquement A-Z 0-9 _ -",
+ "passphrase": "Phrase de mot de passe",
+ "passphraseShort": "Phrase de mot de passe trop courte",
+ "optional": "Facultatif",
+ "cancel": "Annuler",
+ "generate": "Générer une clé",
+ "noSshKeys": "Pas de clé SSH",
+ "copyPublicKey": "Copier la clé publique dans le presse-papiers",
+ "delete": "Supprimer une clé",
+ "gitConfig": "Configuration Git",
+ "deleteConfirm": "Êtes-vous sûr de vouloir supprimer la clé SSH __nom__ ? Ça ne peut pas être annulé."
+ },
+ "versionControl": {
+ "unstagedChanges": "Abandon des changements",
+ "stagedChanges": "Changement mis en place",
+ "unstageChange": "Ne pas mettre en place le changement",
+ "stageChange": "Mettre en place le changement",
+ "unstageAllChange": "Ne pas mettre en place tous les changements",
+ "stageAllChange": "Mettre en place tous les changements",
+ "commitChanges": "Valider les changements",
+ "resolveConflicts": "Résoudre les conflits",
+ "head": "En-tête",
+ "staged": "Mis en place",
+ "unstaged": "Non mis en place",
+ "local": "Local",
+ "remote": "Distant",
+ "revert": "Voulez-vous vraiment annuler les modifications apportées à '__file__' ? Ça ne peut pas être annulé.",
+ "revertChanges": "Rétablir les changements",
+ "localChanges": "Modifications locales",
+ "none": "Vide",
+ "conflictResolve": "Tous les conflits ont été résolus. Valider les modifications pour terminer la fusion.",
+ "localFiles": "Fichiers locaux",
+ "all": "tout",
+ "unmergedChanges": "Modifications non fusionnées",
+ "abortMerge": "Abandonner la fusion",
+ "commit": "Valider",
+ "changeToCommit": "Modifications à valider",
+ "commitPlaceholder": "Entrer votre message de validation",
+ "cancelCapital": "Annuler",
+ "commitCapital": "Valider",
+ "commitHistory": "Historique des validations",
+ "branch": "Branche :",
+ "moreCommits": "Davantage de validations",
+ "changeLocalBranch": "Changer de branche locale",
+ "createBranchPlaceholder": "Trouver où créer une branche",
+ "upstream": "en amont",
+ "localOverwrite": "Vous avez des modifications locales qui seraient écrasées en changeant la branche. Vous devez d'abord valider ou annuler ces modifications.",
+ "manageRemoteBranch": "Gérer une branche distante",
+ "unableToAccess": "Impossible d'accéder au référentiel distant",
+ "retry": "Recommencer",
+ "setUpstreamBranch": "Définir comme branche en amont",
+ "createRemoteBranchPlaceholder": "Trouver ou créer une branche distante",
+ "trackedUpstreamBranch": "La branche créée sera définie comme la branche en amont suivie.",
+ "selectUpstreamBranch": "La branche sera créée. Sélectionner ci-dessous pour la définir comme branche en amont suivie.",
+ "pushFailed": "L'envoi a échoué car la branche a des validations plus récentes. Tirer et fusionner d'abord, puis envoyer à nouveau.",
+ "push": "Envoyer",
+ "pull": "Tirer",
+ "unablePull": "
Impossible d'extraire les modifications à distance ; vos modifications locales non mises en place seraient écrasées.
Valider vos modifications et réessayer.
",
+ "showUnstagedChanges": "Afficher les modifications non mise en place",
+ "connectionFailed": "Impossible de se connecter au référentiel distant: ",
+ "pullUnrelatedHistory": "
Le réferentiel distant a un historique de validations sans rapport.
Êtes-vous sûr de vouloir extraire les modifications dans votre référentiel local ?
",
+ "pullChanges": "Tirer les changements",
+ "history": "Historique",
+ "projectHistory": "Historique du projet",
+ "daysAgo": "il y a __count__ jour",
+ "daysAgo_plural": "il y a __count__ jours",
+ "hoursAgo": "il y a __count__ heure",
+ "hoursAgo_plural": "il y a __count__ heures",
+ "minsAgo": "il y a __count__ minute",
+ "minsAgo_plural": "il y a __count__ minutes",
+ "secondsAgo": "Il y a quelques instants",
+ "notTracking": "Votre branche locale ne suit pas actuellement une branche distante.",
+ "statusUnmergedChanged": "Votre référentiel contient des modifications non fusionnées. Vous devez résoudre les conflits et valider le résultat.",
+ "repositoryUpToDate": "Votre référentiel est à jour.",
+ "commitsAhead": "Votre référentiel a __count__ validation d'avance sur le référentiel distant. Vous pouvez pousser cette validation maintenant.",
+ "commitsAhead_plural": "Votre référentiel a __count__ validations d'avance sur le référentiel distant. Vous pouvez pousser ces validations maintenant.",
+ "commitsBehind": "Votre référentiel a __count__ validation de retard sur le référentiel distant. Vous pouvez pousser cette validation maintenant.",
+ "commitsBehind_plural": "Votre référentiel a __count__ validations de retard sur le référentiel distant. Vous pouvez pousser ces validations maintenant.",
+ "commitsAheadAndBehind1": "Votre référentiel a __count__ validation derrière et ",
+ "commitsAheadAndBehind1_plural": "Votre référentiel est __count__ validations derrière et ",
+ "commitsAheadAndBehind2": "__count__ validation avant le référentiel distant. ",
+ "validationsAheadAndBehind2_plural": "__count__ commits avant le référentiel distant. ",
+ "commitsAheadAndBehind3": "Vous devez retirer la validation à distance avant de pousser la modification.",
+ "commitsAheadAndBehind3_plural": "Vous devez retirer les validations à distance avant de pousser les modifications.",
+ "refreshCommitHistory": "Actualiser l'historique des validations",
+ "refreshChanges": "Actualiser les modifications"
+ }
+ }
+ },
+ "typedInput": {
+ "type": {
+ "str": "chaîne de caractères",
+ "num": "nombre",
+ "re": "expression régulière",
+ "bool": "booléen",
+ "json": "JSON",
+ "bin": "tampon",
+ "date": "horodatage",
+ "jsonata": "expression",
+ "env": "variable d'environnement",
+ "cred": "identifiant"
+ }
+ },
+ "editableList": {
+ "add": "Ajouter",
+ "addTitle": "Ajouter un élément"
+ },
+ "search": {
+ "history": "Historique des recherches",
+ "clear": "Tout effacer",
+ "empty": "Aucun résultat",
+ "addNode": "Ajouter un noeud...",
+ "options": {
+ "configNodes": "Noeuds de configuration",
+ "unusedConfigNodes": "Noeuds de configuration inutilisés",
+ "invalidNodes": "Noeuds invalides",
+ "uknownNodes": "Noeuds inconnus",
+ "unusedSubflows": "Sous-flux inutilisés",
+ "hiddenFlows": "Flux cachés",
+ "modifiedNodes": "Noeuds et flux modifiés",
+ "thisFlow": "Flux courant"
+ }
+ },
+ "expressionEditor": {
+ "functions": "Fonctions",
+ "functionReference": "Fonction de référence",
+ "insert": "Insérer",
+ "title": "Éditeur d'expressions JSONata",
+ "test": "Test",
+ "data": "Exemple de message",
+ "result": "Résultat",
+ "format": "Format",
+ "compatMode": "Mode de compatibilité activé",
+ "compatModeDesc": "
Mode de compatibilité JSONata
L'expression actuelle semble toujours faire référence à msg et sera donc évaluée en mode de compatibilité. Veuiller mettre à jour l'expression pour ne pas utiliser msg car ce mode sera supprimé à l'avenir.
Lorsque la prise en charge de JSONata a été ajoutée pour la première fois à Node-RED, il fallait que l'expression référencie l'objet msg. Par exemple, msg.payload serait utilisé pour accéder à la charge utile.
Cela n'est plus nécessaire car l'expression sera évaluée directement par rapport au message. Pour accéder à la charge utile, l'expression doit être simplement charge utile.
",
+ "noMatch": "Aucun résultat correspondant",
+ "errors": {
+ "invalid-expr": "Expression JSONata non valide :\n __message__",
+ "invalid-msg": "Exemple de message JSON non valide :\n __message__",
+ "context-unsupported": "Impossible de tester les fonctions de contexte\n $flowContext ou $globalContext",
+ "env-unsupported": "Impossible de tester la fonction $env",
+ "moment-unsupported": "Impossible de tester la fonction $moment",
+ "clone-unsupported": "Impossible de tester la fonction $clone",
+ "eval": "Erreur lors de l'évaluation de l'expression :\n __message__"
+ }
+ },
+ "monaco": {
+ "setTheme": "Définir le thème"
+ },
+ "jsEditor": {
+ "title": "Éditeur JavaScript"
+ },
+ "textEditor": {
+ "title": "Éditeur de texte"
+ },
+ "jsonEditor": {
+ "title": "Éditeur JSON",
+ "format": "Format JSON",
+ "rawMode": "Modifier JSON",
+ "uiMode": "Afficher l'éditeur",
+ "rawMode-readonly": "JSON",
+ "uiMode-readonly": "Visualiser",
+ "insertAbove": "Insérer ci-dessus",
+ "insertBelow": "Insérer ci-dessous",
+ "addItem": "Ajouter un élément",
+ "copyPath": "Copier le chemin vers l'élément",
+ "expandItems": "Développer les éléments",
+ "collapseItems": "Réduire les éléments",
+ "duplicate": "Dupliquer",
+ "error": {
+ "invalidJSON": "JSON invalide : "
+ }
+ },
+ "markdownEditor": {
+ "title": "Éditeur Markdown",
+ "expand": "Développer",
+ "format": "Formaté avec Markdown",
+ "heading1": "Rubrique 1",
+ "heading2": "Rubrique 2",
+ "heading3": "Rubrique 3",
+ "bold": "Gras",
+ "italic": "Italic",
+ "code": "Code",
+ "ordered-list": "Liste ordonnée",
+ "unordered-list": "Liste non ordonnée",
+ "quote": "Citation",
+ "link": "Lien",
+ "horizontal-rule": "Règle horizontale",
+ "toggle-preview": "Basculer l'aperçu",
+ "mermaid": {
+ "summary": "Diagramme Mermaid"
+ }
+ },
+ "bufferEditor": {
+ "title": "Éditeur de tampon",
+ "modeString": "Gérer comme une chaîne UTF-8",
+ "modeArray": "Gérer en tant que tableau JSON",
+ "modeDesc": "
Éditeur de tampon
Le type de tampon est stocké sous la forme d'un tableau JSON de valeurs d'octets. L'éditeur tentera d'analyser la valeur saisie en tant que tableau JSON. S'il ne s'agit pas d'un JSON valide, il sera traité comme une chaîne UTF-8 et converti en un tableau de points de code de caractères individuels.
Par exemple, une valeur de Hello World sera converti en tableau JSON :
"
+ },
+ "projects": {
+ "config-git": "Configurer le client Git",
+ "welcome": {
+ "hello": "Bonjour! Nous avons introduit des 'projets' dans Node-RED.",
+ "desc0": "Il s'agit d'une nouvelle façon pour vous de gérer vos fichiers de flux, cela inclut le contrôle de version de vos flux.",
+ "desc1": "Pour commencer, vous pouvez créer votre premier projet ou cloner un projet existant à partir d'un référentiel git.",
+ "desc2": "Si vous n'êtes pas sûr, vous pouvez ignorer ceci pour le moment. Vous pourrez toujours créer votre premier projet à partir du menu 'Projets' à tout moment.",
+ "create": "Créer un projet",
+ "clone": "Cloner un référentiel",
+ "openExistingProject": "Ouvrir un projet existant",
+ "not-right-now": "Pas maintenant"
+ },
+ "git-config": {
+ "setup": "Configurer votre version du client Git",
+ "desc0": "Node-RED utilise l'outil open source Git pour le contrôle de version. Il suit les modifications apportées à vos fichiers de projet et vous permet de les transférer vers des référentiels distants.",
+ "desc1": "Lorsque vous validez un ensemble de modifications, Git enregistre l'auteur qui a effectué les modifications avec un nom d'utilisateur et une adresse e-mail. Le nom d'utilisateur peut être ce que vous voulez - il n'est pas nécessaire que ce soit votre vrai nom.",
+ "desc2": "Votre client Git est déjà configuré avec les détails ci-dessous.",
+ "desc3": "Vous pouvez modifier ces paramètres ultérieurement sous l'onglet 'Configuration Git' de la boîte de dialogue des paramètres.",
+ "username": "Nom d'utilisateur",
+ "email": "e-mail"
+ },
+ "project-details": {
+ "create": "Créer votre projet",
+ "desc0": "Un projet est maintenu en tant que référentiel Git. Il est beaucoup plus facile de partager vos flux et de collaborer avec les autres grâce à ce référentiel.",
+ "desc1": "Vous pouvez créer plusieurs projets et basculer rapidement entre eux depuis l'éditeur.",
+ "desc2": "Pour commencer, votre projet a besoin d'un nom et facultativement d'une description.",
+ "already-exists": "Le projet existe déjà",
+ "must-contain": "Doit contenir uniquement A-Z 0-9 _ -",
+ "project-name": "Nom du projet",
+ "desc": "Description",
+ "opt": "Facultatif"
+ },
+ "clone-project": {
+ "clone": "Cloner un projet",
+ "desc0": "Si vous avez déjà un dépôt Git contenant un projet, vous pouvez le cloner pour commencer.",
+ "already-exists": "Le projet existe déjà",
+ "must-contain": "Doit contenir uniquement A-Z 0-9 _ -",
+ "project-name": "Nom du projet",
+ "no-info-in-url": "Ne pas inclure le nom d'utilisateur/mot de passe dans l'URL",
+ "git-url": "URL du dépôt Git",
+ "protocols": "https://, ssh:// ou file://",
+ "auth-failed": "L'authentification a échoué",
+ "username": "Nom d'utilisateur",
+ "passwd": "Mot de passe",
+ "ssh-key": "Clé SSH",
+ "passphrase": "Phrase de mot de passe",
+ "ssh-key-desc": "Avant de pouvoir cloner un référentiel avec ssh, vous devez ajouter une clé SSH pour y accéder.",
+ "ssh-key-add": "Ajouter une clé ssh",
+ "credential-key": "Clé de chiffrement des identifiants",
+ "cant-get-ssh-key": "Erreur! Impossible d'obtenir le chemin de la clé SSH sélectionnée.",
+ "already-exists2": "Existe déjà",
+ "git-error": "Erreur git",
+ "connection-failed": "La connexion a échoué",
+ "not-git-repo": "Ce n'est pas un dépôt Git",
+ "repo-not-found": "Référentiel introuvable"
+ },
+ "default-files": {
+ "create": "Créer vos fichiers de projet",
+ "desc0": "Un projet contient vos fichiers de flux, un fichier README et un fichier package.json.",
+ "desc1": "Il peut contenir tous les autres fichiers que vous souhaitez conserver dans le référentiel Git.",
+ "desc2": "Vos fichiers de flux et identifiants existants seront copiés dans le projet.",
+ "flow-file": "Fichier de flux",
+ "credentials-file": "Fichier d'identifiants"
+ },
+ "encryption-config": {
+ "setup": "Configuration du chiffrage de votre fichier d'informations d'identification",
+ "desc0": "Votre fichier d'informations d'identification de flux peut être chiffré pour sécuriser son contenu.",
+ "desc1": "Si vous souhaitez stocker ces identifiants dans un référentiel Git public, vous devez les chiffrer en fournissant une phrase clé secrète.",
+ "desc2": "Votre fichier d'identifiants de flux n'est actuellement pas chiffré.",
+ "desc3": "Cela signifie que son contenu, tel que les mots de passe et les jetons d'accès, peut être lu par toute personne ayant accès au fichier.",
+ "desc4": "Si vous souhaitez stocker ces identifiants dans un référentiel Git public, vous devez les chiffrer en fournissant une phrase clé secrète.",
+ "desc5": "Votre fichier contenant les identifiants de flux est actuellement chiffré à l'aide de la propriété credentialSecret de votre fichier de paramètres comme clé.",
+ "desc6": "Votre fichier contenant les identifiants de flux est actuellement chiffré à l'aide d'une clé générée par le système. Vous devez fournir une nouvelle clé secrète pour ce projet.",
+ "desc7": "La clé sera stockée séparément de vos fichiers de projet. Vous devrez fournir la clé pour utiliser ce projet dans une autre instance de Node-RED.",
+ "credentials": "Identifiants",
+ "enable": "Activer le chiffrement",
+ "disable": "Désactiver le chiffrement",
+ "disabled": "Désactivé",
+ "copy": "Remplacer la clé existante",
+ "use-custom": "Utiliser la clé personnalisée",
+ "desc8": "Le fichier contenant les identifiants ne sera pas crypté et son contenu sera facilement lisible",
+ "create-project-files": "Créer des fichiers de projet",
+ "create-project": "Créer un projet",
+ "already-exists": "existe déjà",
+ "git-error": "Erreur Git",
+ "git-auth-error": "erreur d'authentification Git"
+ },
+ "create-success": {
+ "success": "Vous avez créé avec succès votre premier projet !",
+ "desc0": "Vous pouvez maintenant continuer à utiliser Node-RED comme vous l'avez toujours fait.",
+ "desc1": "L'onglet 'info' dans la barre latérale vous montre quel est votre projet actif actuel. Le bouton à côté du nom peut être utilisé pour accéder à la vue des paramètres du projet.",
+ "desc2": "L'onglet 'historique' dans la barre latérale peut être utilisé pour afficher les fichiers qui ont changé dans votre projet et pour les valider. Il vous montre un historique complet de vos validations (commits) et vous permet de pousser vos modifications vers un référentiel distant."
+ },
+ "create": {
+ "projects": "Projets",
+ "already-exists": "Le projet existe déjà",
+ "must-contain": "Doit contenir uniquement A-Z 0-9 _ -",
+ "no-info-in-url": "Ne pas inclure le nom d'utilisateur/mot de passe dans l'URL",
+ "open": "Projet ouvert",
+ "create": "Créer un projet",
+ "clone": "Cloner un référentiel",
+ "project-name": "Nom du projet",
+ "desc": "Description",
+ "opt": "Facultatif",
+ "flow-file": "Fichier de flux",
+ "credentials": "Identifiants",
+ "enable-encryption": "Activer le chiffrement",
+ "disable-encryption": "Désactiver le chiffrement",
+ "encryption-key": "Clé de chiffrement",
+ "desc0": "Une phrase pour sécuriser vos identifiants",
+ "desc1": "Le fichier contenant les identifiants ne sera pas crypté et son contenu sera facilement lisible",
+ "git-url": "URL du dépôt Git",
+ "protocols": "https://, ssh:// ou file://",
+ "auth-failed": "L'authentification a échoué",
+ "username": "Nom d'utilisateur",
+ "password": "Mot de passe",
+ "ssh-key": "Clé SSH",
+ "passphrase": "Phrase de mot de passe",
+ "desc2": "Avant de pouvoir cloner un référentiel sur ssh, vous devez ajouter une clé SSH pour y accéder.",
+ "add-ssh-key": "Ajouter une clé ssh",
+ "credentials-encryption-key": "Clé de chiffrement des identifiants",
+ "already-exists-2": "existe déjà",
+ "git-error": "erreur git",
+ "con-failed": "La connexion a échoué",
+ "not-git": "Ce n'est pas un dépôt git",
+ "no-resource": "Référentiel introuvable",
+ "cant-get-ssh-key-path": "Erreur! Impossible d'obtenir le chemin de la clé SSH sélectionnée.",
+ "unexpected_error": "Erreur inattendue",
+ "clearContext": "Effacer le contexte lors du changement de projet"
+ },
+ "delete": {
+ "confirm": "Voulez-vous vraiment supprimer ce projet ?"
+ },
+ "create-project-list": {
+ "search": "rechercher vos projets",
+ "current": "actuel"
+ },
+ "require-clean": {
+ "confirm": "
Vous avez des modifications non déployées qui seront perdues.
Voulez-vous continuer ?
"
+ },
+ "send-req": {
+ "auth-req": "Authentification requise pour le référentiel",
+ "username": "Nom d'utilisateur",
+ "password": "Mot de passe",
+ "passphrase": "Phrase de mot de passe",
+ "retry": "Recommencer",
+ "update-failed": "La mise à jour a échoué",
+ "unhandled": "Code d'erreur non géré",
+ "host-key-verify-failed": "
La vérification de la clé d'hôte a échoué.
La clé d'hôte du référentiel n'a pas pu être vérifiée. Veuillez mettre à jour votre fichier known_hosts et réessayer.
"
+ },
+ "create-branch-list": {
+ "invalid": "Branche invalide",
+ "create": "Créer une branche",
+ "current": "Actuelle"
+ },
+ "create-default-file-set": {
+ "no-active": "Impossible de créer un ensemble de fichiers par défaut sans projet actif",
+ "no-empty": "Impossible de créer un ensemble de fichiers par défaut sur un projet non vide",
+ "git-error": "Erreur Git"
+ },
+ "errors": {
+ "no-username-email": "Votre client Git n'est pas configuré avec un nom d'utilisateur/e-mail.",
+ "unexpected": "Une erreur inattendue est apparue",
+ "code": "Code"
+ }
+ },
+ "editor-tab": {
+ "properties": "Propriétés",
+ "envProperties": "Variables d'environnement",
+ "module": "Propriétés des modules",
+ "description": "Description",
+ "appearance": "Apparence",
+ "preview": "Aperçu de l'interface utilisateur",
+ "defaultValue": "Valeur par défaut"
+ },
+ "tourGuide": {
+ "takeATour": "Aperçu",
+ "start": "Commencer",
+ "next": "Suivant",
+ "welcomeTours": "Visite de bienvenue"
+ },
+ "diagnostics": {
+ "title": "Information système"
+ },
+ "languages": {
+ "de": "Allemand",
+ "en-US": "Anglais",
+ "fr": "Français",
+ "ja": "Japonais",
+ "ko": "Coréen",
+ "pt-BR": "Portugais brésilien",
+ "ru": "Russe",
+ "zh-CN": "Chinois (Simplifié)",
+ "zh-TW": "Chinois (Traditionnel)"
+ },
+ "validator": {
+ "errors": {
+ "invalid-json": "Données JSON invalides : __error__",
+ "invalid-json-prop": "__prop__: données JSON invalides : __error__",
+ "invalid-prop": "Expression de propriété non valide",
+ "invalid-prop-prop": "__prop__: expression de propriété invalide",
+ "invalid-num": "Numéro invalide",
+ "invalid-num-prop": "__prop__: numéro invalide",
+ "invalid-regexp": "Modèle d'entrée non valide",
+ "invalid-regex-prop": "__prop__: modèle d'entrée non valide",
+ "missing-required-prop": "__prop__: valeur de la propriété manquante",
+ "invalid-config": "__prop__: noeud de configuration invalide",
+ "missing-config": "__prop__: noeud de configuration manquant",
+ "validation-error": "__prop__: erreur de validation: __node__, __id__: __error__"
+ }
+ },
+ "contextMenu": {
+ "insert": "Insérer",
+ "node": "Noeud",
+ "junction": "Jonction",
+ "linkNodes": "Liens entre les noeuds"
+ },
+ "env-var": {
+ "environment": "Environment",
+ "header": "Variables d'environnement globales",
+ "revert": "Rétablir"
+ }
+}
diff --git a/packages/node_modules/@node-red/editor-client/locales/fr/infotips.json b/packages/node_modules/@node-red/editor-client/locales/fr/infotips.json
new file mode 100755
index 000000000..449be751b
--- /dev/null
+++ b/packages/node_modules/@node-red/editor-client/locales/fr/infotips.json
@@ -0,0 +1,23 @@
+{
+ "info": {
+ "tip0": "Vous pouvez supprimer les noeuds ou les liens sélectionnés avec {{core:delete-selection}}",
+ "tip1": "Rechercher des noeuds à l'aide de {{core:search}}",
+ "tip2": "{{core:toggle-sidebar}} basculera l'affichage de cette barre latérale",
+ "tip3": "Vous pouvez gérer votre palette de noeuds avec {{core:manage-palette}}",
+ "tip4": "Vos noeuds de configuration de flux sont répertoriés dans le panneau de la barre latérale. Ils sont accessibles depuis le menu ou avec {{core:show-config-tab}}",
+ "tip5": "Activer ou désactiver ces conseils à partir de l'option dans les paramètres",
+ "tip6": "Déplacer les noeuds sélectionnés à l'aide des touches [gauche] [haut] [bas] et [droite]. Maintenir la touche [shift] enfoncée pour les pousser plus loin",
+ "tip7": "Faire glisser un noeud sur un fil le raccordera au lien",
+ "tip8": "Exporter les noeuds sélectionnés, ou l'onglet actuel avec {{core:show-export-dialog}}",
+ "tip9": "Importer un flux en faisant glisser son JSON dans l'éditeur, ou avec {{core:show-import-dialog}}",
+ "tip10": "[majuscule] [clic] et faites glisser sur un port de noeud pour déplacer tous les fils attachés ou seulement celui sélectionné",
+ "tip11": "Afficher l'onglet Infos avec {{core:show-info-tab}} ou l'onglet Débogage avec {{core:show-debug-tab}}",
+ "tip12": "[ctrl] [clic] dans l'espace de travail pour ouvrir la boîte de dialogue d'ajout rapide",
+ "tip13": "Maintenir la touche [ctrl] enfoncée lorsque vous [cliquez] sur un port de noeud pour activer le câblage rapide",
+ "tip14": "Maintenir la touche [shift] enfoncée lorsque vous [cliquez] sur un noeud pour sélectionner également tous ses noeuds connectés",
+ "tip15": "Maintenir la touche [ctrl] enfoncée lorsque vous [cliquez] sur un noeud pour l'ajouter ou le supprimer de la sélection actuelle",
+ "tip16": "Changer d'onglet de flux avec {{core:show-previous-tab}} et {{core:show-next-tab}}",
+ "tip17": "Vous pouvez confirmer vos modifications dans le panneau d'édition du noeud avec {{core:confirm-edit-tray}} ou les annuler avec {{core:cancel-edit-tray}}",
+ "tip18": "Appuyer sur {{core:edit-selected-node}} modifiera le premier noeud de la sélection actuelle"
+ }
+}
\ No newline at end of file
diff --git a/packages/node_modules/@node-red/editor-client/locales/fr/jsonata.json b/packages/node_modules/@node-red/editor-client/locales/fr/jsonata.json
new file mode 100755
index 000000000..8fd65bf72
--- /dev/null
+++ b/packages/node_modules/@node-red/editor-client/locales/fr/jsonata.json
@@ -0,0 +1,274 @@
+{
+ "$string": {
+ "args": "arg[, prettify]",
+ "desc": "Convertit le paramètre `arg` en une chaîne de caractères en utilisant les règles de typage suivantes :\n\n - Les chaînes de caractères sont inchangées\n - Les fonctions sont converties en une chaîne vide\n - L'infini numérique et NaN renvoient une erreur car ils ne peuvent pas être représentés comme un Numéro JSON\n - Toutes les autres valeurs sont converties en une chaîne JSON à l'aide de la fonction `JSON.stringify`. Si `prettify` est vrai, alors le JSON \"prettified\" est produit. c'est-à-dire une ligne par champ et les lignes seront en retrait en fonction de la profondeur du champ."
+ },
+ "$length": {
+ "args": "str",
+ "desc": "Renvoie le nombre de caractères dans la chaîne `str`. Une erreur est renvoyée si `str` n'est pas une chaîne de caractères."
+ },
+ "$substring": {
+ "args": "str, start[, length]",
+ "desc": "Renvoie une chaîne contenant les caractères du premier paramètre `str` commençant à la position `start` (pas de décalage). Si `length` est spécifié, alors la sous-chaîne contiendra un maximum de caractères `length`. Si `start` est négatif alors il indique le nombre de caractères à partir de la fin de `str`."
+ },
+ "$substringBefore": {
+ "args": "str, chars",
+ "desc": "Renvoie la sous-chaîne avant la première occurrence de la séquence de caractères `chars` dans `str`. Si `str` ne contient pas `chars`, alors il renvoie `str`."
+ },
+ "$substringAfter": {
+ "args": "str, chars",
+ "desc": "Renvoie la sous-chaîne après la première occurrence de la séquence de caractères `chars` dans `str`. Si `str` ne contient pas `chars`, alors il renvoie `str`."
+ },
+ "$uppercase": {
+ "args": "str",
+ "desc": "Renvoie une chaîne avec tous les caractères de `str` convertis en majuscules."
+ },
+ "$lowercase": {
+ "args": "str",
+ "desc": "Renvoie une chaîne avec tous les caractères de `str` convertis en minuscules."
+ },
+ "$trim": {
+ "args": "str",
+ "desc": "Normalise et supprime tous les caractères d'espacement dans `str` en appliquant les étapes suivantes :\n\n - Toutes les tabulations, retours à la ligne et sauts de ligne sont remplacés par des espaces.\n- Les séquences contiguës d'espaces sont réduites à un seul espace.\n- Les espaces de fin et de début sont supprimés.\n\n Si `str` n'est pas spécifié (c'est-à-dire que cette fonction est invoquée sans argument), alors la valeur de contexte est utilisée comme valeur de `str`. Une erreur est renvoyée si `str` n'est pas une chaîne."
+ },
+ "$contains": {
+ "args": "str, pattern",
+ "desc": "Renvoie `true` si `str` correspond à `pattern`, sinon il renvoie `false`. Si `str` n'est pas spécifié (c'est-à-dire que cette fonction est invoquée avec un argument), alors la valeur de contexte est utilisée comme valeur de `str`. Le paramètre `pattern` peut être une chaîne ou une expression régulière."
+ },
+ "$split": {
+ "args": "str[, separator][, limit]",
+ "desc": "Divise le paramètre `str` en un tableau de sous-chaînes. C'est une erreur si `str` n'est pas une chaîne. Le paramètre facultatif `separator` spécifie les caractères à l'intérieur de `str` à propos desquels il doit être divisé en chaîne ou en expression régulière. Si `separator` n'est pas spécifié, la chaîne vide est supposée et `str` sera divisé en un tableau de caractères uniques. C'est une erreur si `separator` n'est pas une chaîne. Le paramètre facultatif `limit` est un nombre qui spécifie le nombre maximum de sous-chaînes à inclure dans le tableau résultant. Toutes les sous-chaînes supplémentaires sont ignorées. Si `limit` n'est pas spécifié, alors `str` est entièrement divisé sans limite à la taille du tableau résultant. C'est une erreur si `limit` n'est pas un nombre non négatif."
+ },
+ "$join": {
+ "args": "array[, separator]",
+ "desc": "Joint un tableau de chaînes de composants en une seule chaîne concaténée, chaque chaîne de composants étant séparée par le paramètre facultatif `separator`. C'est une erreur si l'entrée `array` contient un élément qui n'est pas une chaîne. Si `séparateur` n'est pas spécifié, il est supposé être la chaîne vide, c'est-à-dire qu'il n'y a pas de `séparateur` entre les chaînes de composants. C'est une erreur si `separator` n'est pas une chaîne."
+ },
+ "$match": {
+ "args": "str, pattern [, limit]",
+ "desc": "Applique la chaîne `str` à l'expression régulière `pattern` et renvoie un tableau d'objets, chaque objet contenant des informations sur chaque occurrence d'une correspondance dans `str`."
+ },
+ "$replace": {
+ "args": "str, pattern, replacement [, limit]",
+ "desc": "Trouve les occurrences de `pattern` dans `str` et les remplace par `replacement`.\n\nLe paramètre facultatif `limit` est le nombre maximum de remplacements."
+ },
+ "$now": {
+ "args": "$[picture [, timezone]]",
+ "desc": "Génère un horodatage au format compatible ISO 8601 et le renvoie sous forme de chaîne. Si les paramètres optionnels d'image et de fuseau horaire sont fournis, alors l'horodatage actuel est formaté comme décrit par la fonction `$fromMillis()`"
+ },
+ "$base64encode": {
+ "args": "string",
+ "desc": "Convertit une chaîne ASCII en une représentation en base 64. Chaque caractère de la chaîne est traité comme un octet de données binaires. Cela nécessite que tous les caractères de la chaîne se trouvent dans la plage 0x00 à 0xFF, qui inclut tous les caractères des chaînes encodées en URI. Les caractères Unicode en dehors de cette plage ne sont pas pris en charge."
+ },
+ "$base64decode": {
+ "args": "string",
+ "desc": "Convertit les octets encodés en base 64 en une chaîne, à l'aide d'une page de codes Unicode UTF-8."
+ },
+ "$number": {
+ "args": "arg",
+ "desc": "Convertit le paramètre `arg` en un nombre en utilisant les règles de conversion suivantes :\n\n - Les nombres sont inchangés\n - Les chaînes qui contiennent une séquence de caractères représentant un nombre JSON légal sont converties en ce nombre\n - Toutes les autres valeurs provoquer l'envoi d'une erreur."
+ },
+ "$abs": {
+ "args": "number",
+ "desc": "Renvoie la valeur absolue du paramètre `nombre`."
+ },
+ "$floor": {
+ "args": "number",
+ "desc": "Renvoie la valeur de `number` arrondie à l'entier le plus proche inférieur ou égal à `number`."
+ },
+ "$ceil": {
+ "args": "number",
+ "desc": "Renvoie la valeur de `number` arrondie à l'entier le plus proche supérieur ou égal à `number`."
+ },
+ "$round": {
+ "args": "number [, precision]",
+ "desc": "Renvoie la valeur du paramètre `number` arrondie au nombre de décimales spécifié par le paramètre facultatif `precision`."
+ },
+ "$power": {
+ "args": "base, exponent",
+ "desc": "Renvoie la valeur de `base` élevée à la puissance de `exponent`."
+ },
+ "$sqrt": {
+ "args": "number",
+ "desc": "Renvoie la racine carrée de la valeur du paramètre `number`."
+ },
+ "$random": {
+ "args": "",
+ "desc": "Renvoie un nombre pseudo-aléatoire supérieur ou égal à zéro et inférieur à un."
+ },
+ "$millis": {
+ "args": "",
+ "desc": "Renvoie le nombre de millisecondes depuis l'époque Unix (1er janvier 1970 UTC) sous forme de nombre. Tous les appels de `$millis()` dans une évaluation d'une expression renverront toutes la même valeur."
+ },
+ "$sum": {
+ "args": "array",
+ "desc": "Renvoie la somme arithmétique d'un `tableau` de nombres. C'est une erreur si l'entrée `array` contient un élément qui n'est pas un nombre."
+ },
+ "$max": {
+ "args": "array",
+ "desc": "Renvoie le nombre maximal dans un `tableau` de nombres. C'est une erreur si l'entrée `array` contient un élément qui n'est pas un nombre."
+ },
+ "$min": {
+ "args": "array",
+ "desc": "Renvoie le nombre minimum dans un `tableau` de nombres. C'est une erreur si l'entrée `array` contient un élément qui n'est pas un nombre."
+ },
+ "$average": {
+ "args": "array",
+ "desc": "Renvoie la valeur moyenne d'un `tableau` de nombres. C'est une erreur si l'entrée `array` contient un élément qui n'est pas un nombre."
+ },
+ "$boolean": {
+ "args": "arg",
+ "desc": "Transforme l'argument en booléen en utilisant les règles suivantes :\n\n - `Boolean` : inchangé\n - `string` : vide : `false`\n - `string` : non vide : `true`\n - `number` : `0` : `false`\n - `number` : non nul : `true`\n - `null` : `false`\n - `array` : vide : `false`\n - `array` : contient un membre qui convertit en `true` : `true`\n - `array` : tous les membres sont transformés en `false` : `false`\n - `object` : vide : `false`\n - `object` : non vide : `true`\n - `function` : `false`"
+ },
+ "$not": {
+ "args": "arg",
+ "desc": "Renvoie un booléen résultat de la négation logique de l'argument"
+ },
+ "$exists": {
+ "args": "arg",
+ "desc": "Renvoie la valeur booléenne `true` si l'expression `arg` est évaluée à une valeur, ou `false` si l'expression ne correspond à rien (par exemple, un chemin vers une référence de champ inexistante)."
+ },
+ "$count": {
+ "args": "array",
+ "desc": "Renvoie le nombre d'éléments du tableau"
+ },
+ "$append": {
+ "args": "array, array",
+ "desc": "Combine deux tableaux"
+ },
+ "$sort": {
+ "args": "array [, function]",
+ "desc": "Renvoie un tableau contenant toutes les valeurs du paramètre `array`, mais triées dans l'ordre.\n\nSi un comparateur `function` est fourni, alors il doit s'agir d'une fonction qui prend deux paramètres :\n\n`function(left , droite)`\n\nCette fonction est invoquée par l'algorithme de tri pour comparer deux valeurs à gauche et à droite. Si la valeur de left doit être placée après la valeur de right dans l'ordre de tri souhaité, la fonction doit renvoyer un booléen `true` pour indiquer un échange. Sinon, il doit renvoyer `false`."
+ },
+ "$reverse": {
+ "args": "array",
+ "desc": "Renvoie un tableau contenant toutes les valeurs du paramètre `array`, mais dans l'ordre inverse."
+ },
+ "$shuffle": {
+ "args": "array",
+ "desc": "Renvoie un tableau contenant toutes les valeurs du paramètre `array`, mais mélangées dans un ordre aléatoire."
+ },
+ "$zip": {
+ "args": "array, ...",
+ "desc": "Renvoie un tableau convolué (zippé) contenant des tableaux groupés de valeurs des arguments `array1`...`arrayN` d'index 0, 1, 2...."
+ },
+ "$keys": {
+ "args": "object",
+ "desc": "Renvoie un tableau contenant les clés de l'objet. Si l'argument est un tableau d'objets, le tableau renvoyé contient une liste dédupliquée de toutes les clés de tous les objets."
+ },
+ "$lookup": {
+ "args": "object, key",
+ "desc": "Renvoie la valeur associée à la clé dans l'objet. Si le premier argument est un tableau d'objets, tous les objets du tableau sont recherchés et les valeurs associées à toutes les occurrences de key sont renvoyées."
+ },
+ "$spread": {
+ "args": "object",
+ "desc": "Divise un objet contenant des paires clé/valeur en un tableau d'objets, chacun ayant une seule paire clé/valeur de l'objet d'entrée. Si le paramètre est un tableau d'objets, alors le tableau résultant contient un objet pour chaque paire clé/valeur dans chaque objet du tableau fourni."
+ },
+ "$merge": {
+ "args": "array<object>",
+ "desc": "Fusionne un tableau d'`objets` en un seul `objet` contenant toutes les paires clé/valeur de chacun des objets du tableau d'entrée. Si l'un des objets d'entrée contient la même clé, alors l'`objet` renvoyé contiendra la valeur du dernier dans le tableau. C'est une erreur si le tableau d'entrée contient un élément qui n'est pas un objet."
+ },
+ "$sift": {
+ "args": "object, function",
+ "desc": "Renvoie un objet qui contient uniquement les paires clé/valeur du paramètre `object` qui satisfont le prédicat `function` transmis comme second paramètre.\n\nLa `function` qui est fournie comme second paramètre doit avoir la signature suivante :\n\n`fonction(valeur [, clé [, objet]])`"
+ },
+ "$each": {
+ "args": "object, function",
+ "desc": "Renvoie un tableau contenant les valeurs renvoyées par la `fonction` lorsqu'elle est appliquée à chaque paire clé/valeur dans l'`objet`."
+ },
+ "$map": {
+ "args": "array, function",
+ "desc": "Renvoie un tableau contenant les résultats de l'application du paramètre `function` à chaque valeur du paramètre `array`.\n\nLa `function` fournie comme second paramètre doit avoir la signature suivante :\n\n`function( valeur [, indice [, tableau]])`"
+ },
+ "$filter": {
+ "args": "array, function",
+ "desc": "Renvoie un tableau contenant uniquement les valeurs du paramètre `array` qui satisfont le prédicat `function`.\n\nLa `function` fournie comme second paramètre doit avoir la signature suivante :\n\n`function(value [ , indice [, tableau]])`"
+ },
+ "$reduce": {
+ "args": "array, function [, init]",
+ "desc": "Renvoie une valeur agrégée dérivée de l'application successive du paramètre `function` à chaque valeur de `array` en combinaison avec le résultat de l'application précédente de la fonction.\n\nLa fonction doit accepter deux arguments et se comporte comme un opérateur infixe entre chaque valeur dans le `tableau`. La signature de `function` doit être de la forme : `myfunc($accumulator, $value[, $index[, $array]])`\n\nLe paramètre facultatif `init` est utilisé comme valeur initiale dans l'agrégation ."
+ },
+ "$flowContext": {
+ "args": "string[, string]",
+ "desc": "Récupère une propriété de contexte de flux.\n\nCeci est une fonction définie par Node-RED."
+ },
+ "$globalContext": {
+ "args": "string[, string]",
+ "desc": "Récupère une propriété de contexte globale.\n\nCeci est une fonction définie par Node-RED."
+ },
+ "$pad": {
+ "args": "string, width [, char]",
+ "desc": "Renvoie une copie de la `chaîne` avec un rembourrage supplémentaire, si nécessaire, de sorte que son nombre total de caractères corresponde au moins à la valeur absolue du paramètre `width`.\n\nSi `width` est un nombre positif, alors la chaîne est rembourré à droite; s'il est négatif, il est rempli vers la gauche.\n\nL'argument optionnel `char` spécifie le(s) caractère(s) de remplissage à utiliser. S'il n'est pas spécifié, la valeur par défaut est le caractère espace."
+ },
+ "$fromMillis": {
+ "args": "number, [, picture [, timezone]]",
+ "desc": "Convertisser le « nombre » représentant les millisecondes depuis l'époque Unix (1er janvier 1970 UTC) en une représentation sous forme de chaîne formatée de l'horodatage tel que spécifié par la chaîne d'image.\n\nSi le paramètre facultatif « image » est omis, l'horodatage est formaté au format ISO 8601.\n\nSi la chaîne facultative `image` est fournie, l'horodatage est formaté selon la représentation spécifiée dans cette chaîne. Le comportement de cette fonction est cohérent avec la version à deux arguments de la fonction XPath/XQuery `format-dateTime` telle que définie dans la spécification XPath F&O 3.1. Le paramètre de chaîne d'image définit la façon dont l'horodatage est formaté et a la même syntaxe que `format-dateTime`.\n\nSi la chaîne facultative `timezone` est fournie, alors l'horodatage formaté sera dans ce fuseau horaire. La chaîne `timezone` doit être au format '±HHMM', où ± est le signe plus ou moins et HHMM est le décalage en heures et minutes par rapport à UTC. Décalage positif pour les fuseaux horaires à l'est de UTC, décalage négatif pour les fuseaux horaires à l'ouest de UTC."
+ },
+ "$formatNumber": {
+ "args": "number, picture [, options]",
+ "desc": "Convertit le `number` en une chaîne et le formate en une représentation décimale comme spécifié par la chaîne `picture`.\n\n Le comportement de cette fonction est cohérent avec la fonction XPath/XQuery fn:format-number telle que définie dans le Spécification XPath F&O 3.1. Le paramètre de chaîne d'image définit la façon dont le nombre est formaté et a la même syntaxe que fn:format-number.\n\nLe troisième argument facultatif `options` est utilisé pour remplacer les caractères de formatage spécifiques aux paramètres régionaux par défaut, tels que le séparateur décimal. S'il est fourni, cet argument doit être un objet contenant des paires nom/valeur spécifiées dans la section de format décimal de la spécification XPath F&O 3.1."
+ },
+ "$formatBase": {
+ "args": "number [, radix]",
+ "desc": "Convertit le `number` en une chaîne et le formate en un entier représenté dans la base numérique spécifiée par l'argument `radix`. Si `radix` n'est pas spécifié, la valeur par défaut est la base 10. `radix` peut être compris entre 2 et 36, sinon une erreur est renvoyée."
+ },
+ "$toMillis": {
+ "args": "timestamp",
+ "desc": "Convertit une chaîne `timestamp` au format ISO 8601 en nombre de millisecondes depuis l'époque Unix (1er janvier 1970 UTC) sous forme de nombre. Une erreur est renvoyée si la chaîne n'est pas au format correct."
+ },
+ "$env": {
+ "args": "arg",
+ "desc": "Renvoie la valeur d'une variable d'environnement.\n\nCeci est une fonction définie par Node-RED."
+ },
+ "$eval": {
+ "args": "expr [, context]",
+ "desc": "Analyse et évalue la chaîne `expr` qui contient un JSON littéral ou une expression JSONata en utilisant le contexte actuel comme contexte d'évaluation."
+ },
+ "$formatInteger": {
+ "args": "number, picture",
+ "desc": "Transforme le `nombre` en une chaîne et le formate en une représentation entière comme spécifié par la chaîne `image`. Le paramètre de chaîne d'image définit la façon dont le nombre est formaté et a la même syntaxe que `fn:format-integer` de la spécification XPath F&O 3.1."
+ },
+ "$parseInteger": {
+ "args": "string, picture",
+ "desc": "Analyse le contenu du paramètre `string` en un entier (comme un nombre JSON) en utilisant le format spécifié par la chaîne `picture`. Le paramètre de chaîne `picture` a le même format que `$formatInteger`."
+ },
+ "$error": {
+ "args": "[str]",
+ "desc": "Génère une erreur avec un message. Le `str` facultatif remplacera le message par défaut de la fonction `$error() évaluée`"
+ },
+ "$assert": {
+ "args": "arg, str",
+ "desc": "Si `arg` est vrai, la fonction renvoie undefined. Si `arg` est faux, une exception est lancée avec `str` comme message de l'exception."
+ },
+ "$single": {
+ "args": "array, function",
+ "desc": "Renvoie la seule et unique valeur du paramètre `array` qui satisfait le prédicat `function` (c'est-à-dire que la `function` renvoie la valeur booléenne `true` lorsqu'elle est transmise à la valeur). Lève une exception si le nombre de valeurs correspondantes n'est pas exactement un.\n\nLa fonction doit être fournie dans la signature suivante : `function(value [, index [, array]])` où value est chaque entrée du tableau, index est la position de cette valeur et le tableau entier est passé comme troisième argument"
+ },
+ "$encodeUrlComponent": {
+ "args": "str",
+ "desc": "Encode un composant URL (Uniform Resource Locator) en remplaçant chaque instance de certains caractères par une, deux, trois ou quatre séquences d'échappement représentant l'encodage UTF-8 du caractère.\n\nExemple : `$encodeUrlComponent(\"?x =test\")` => `\"%3Fx%3Dtest\"`"
+ },
+ "$encodeUrl": {
+ "args": "str",
+ "desc": "Encode une URL (Uniform Resource Locator) en remplaçant chaque instance de certains caractères par une, deux, trois ou quatre séquences d'échappement représentant l'encodage UTF-8 du caractère. \n\nExemple : `$encodeUrl(\"https://mozilla.org/?x=шеллы\")` => `\"https://mozilla.org/?x=%D1%88%D0% B5%D0%BB%D0%BB%D1%8B\"`"
+ },
+ "$decodeUrlComponent": {
+ "args": "str",
+ "desc": "Décode un composant URL (Uniform Resource Locator) précédemment créé par encodeUrlComponent. \n\nExemple : `$decodeUrlComponent(\"%3Fx%3Dtest\")` => `\"?x=test\"`"
+ },
+ "$decodeUrl": {
+ "args": "str",
+ "desc": "Décode une URL (Uniform Resource Locator) précédemment créée par encodeUrl. \n\nExemple : `$decodeUrl(\"https://mozilla.org/?x=%D1%88%D0%B5%D0%BB%D0%BB%D1%8B\")` => `\"https://mozilla.org/?x=шеллы\"`"
+ },
+ "$distinct": {
+ "args": "array",
+ "desc": "Renvoie un tableau avec les valeurs en double supprimées de `array`"
+ },
+ "$type": {
+ "args": "value",
+ "desc": "Renvoie le type de `value` sous forme de chaîne. Si `value` n'est pas défini, cela renverra `undefined`"
+ },
+ "$moment": {
+ "args": "[str]",
+ "desc": "Obtient un objet de date à l'aide de la bibliothèque Moment."
+ }
+}
diff --git a/packages/node_modules/@node-red/editor-client/locales/ja/editor.json b/packages/node_modules/@node-red/editor-client/locales/ja/editor.json
index fb3458eed..84a1f4dad 100644
--- a/packages/node_modules/@node-red/editor-client/locales/ja/editor.json
+++ b/packages/node_modules/@node-red/editor-client/locales/ja/editor.json
@@ -23,7 +23,11 @@
"position": "配置",
"enable": "有効",
"disable": "無効",
- "upload": "アップロード"
+ "upload": "アップロード",
+ "lock": "固定",
+ "unlock": "固定を解除",
+ "locked": "固定済み",
+ "unlocked": "固定なし"
},
"type": {
"string": "文字列",
@@ -53,8 +57,10 @@
"confirmDelete": "削除の確認",
"delete": "本当に '__label__' を削除しますか？",
"dropFlowHere": "ここにフローをドロップしてください",
+ "dropImageHere": "ここに画像ファイルをドロップしてください",
"addFlow": "フローの追加",
"addFlowToRight": "右側にフローを追加",
+ "closeFlow": "フローを閉じる",
"hideFlow": "フローを非表示",
"hideOtherFlows": "他のフローを非表示",
"showAllFlows": "全てのフローを表示",
@@ -68,7 +74,13 @@
"enabled": "有効",
"disabled": "無効",
"info": "詳細",
- "selectNodes": "ノードをクリックして選択"
+ "selectNodes": "ノードをクリックして選択",
+ "enableFlow": "フローを有効化",
+ "disableFlow": "フローを無効化",
+ "lockFlow": "フローを固定",
+ "unlockFlow": "フローの固定を解除",
+ "moveToStart": "フローを先頭へ移動",
+ "moveToEnd": "フローを最後へ移動"
},
"menu": {
"label": {
@@ -101,6 +113,7 @@
"displayStatus": "ノードのステータスを表示",
"displayConfig": "設定ノード",
"import": "読み込み",
+ "importExample": "フロー例を読み込み",
"export": "書き出し",
"search": "ノードを検索",
"searchInput": "ノードを検索",
@@ -497,6 +510,7 @@
"addRemoveNode": "ノードの選択、選択解除",
"editSelected": "選択したノードを編集",
"deleteSelected": "選択したノードや接続を削除",
+ "deleteReconnect": "削除と再接続",
"importNode": "フローの読み込み",
"exportNode": "フローの書き出し",
"nudgeNode": "選択したノードを移動(移動量小)",
@@ -683,7 +697,11 @@
"empty": "空",
"globalConfig": "グローバル設定ノード",
"triggerAction": "アクションを実行",
- "find": "ワークスペース内を検索"
+ "find": "ワークスペース内を検索",
+ "copyItemUrl": "要素のURLをコピー",
+ "copyURL2Clipboard": "URLをクリップボードにコピーしました",
+ "showFlow": "表示",
+ "hideFlow": "非表示"
},
"help": {
"name": "ヘルプ",
@@ -935,8 +953,11 @@
"errors": {
"invalid-expr": "不正なJSONata式:\n __message__",
"invalid-msg": "不正なJSONメッセージ例:\n __message__",
- "context-unsupported": "$flowContext や $globalContextの\nコンテキスト機能をテストできません",
- "eval": "表現評価エラー:\n __message__"
+ "context-unsupported": "$flowContext や $globalContextの\nコンテキスト関数をテストできません",
+ "env-unsupported": "$env関数はテストできません",
+ "moment-unsupported": "$moment関数はテストできません",
+ "clone-unsupported": "$clone関数はテストできません",
+ "eval": "式評価エラー:\n __message__"
}
},
"monaco": {
@@ -981,7 +1002,10 @@
"quote": "引用",
"link": "リンク",
"horizontal-rule": "区切り線",
- "toggle-preview": "プレビュー表示切替え"
+ "toggle-preview": "プレビュー表示切替え",
+ "mermaid": {
+ "summary": "Mermaid図"
+ }
},
"bufferEditor": {
"title": "バッファエディタ",
@@ -1168,8 +1192,7 @@
"takeATour": "ツアーを開始",
"start": "開始",
"next": "次へ",
- "welcomeTours": "ウェルカムツアー",
- "tours": "ツアー"
+ "welcomeTours": "ウェルカムツアー"
},
"diagnostics": {
"title": "システム情報"
@@ -1177,8 +1200,10 @@
"languages": {
"de": "ドイツ語",
"en-US": "英語",
+ "fr": "フランス語",
"ja": "日本語",
"ko": "韓国語",
+ "pt-BR":"ポルトガル語",
"ru": "ロシア語",
"zh-CN": "中国語(簡体)",
"zh-TW": "中国語(繁体)"
@@ -1205,6 +1230,11 @@
"junction": "分岐点",
"linkNodes": "Linkノード"
},
+ "env-var": {
+ "environment": "環境変数",
+ "header": "大域環境変数",
+ "revert": "破棄"
+ },
"action-list": {
"toggle-show-tips": "ヒント表示切替",
"show-about": "Node-REDの説明を表示",
@@ -1289,6 +1319,7 @@
"distribute-selection-vertically": "選択を上下に整列",
"wire-series-of-nodes": "ノードを一続きに接続",
"wire-node-to-multiple": "ノードを複数に接続",
+ "wire-multiple-to-node": "複数からノードへ接続",
"split-wire-with-link-nodes": "ワイヤーをlinkノードで分割",
"generate-node-names": "ノード名を生成",
"show-user-settings": "ユーザ設定を表示",
@@ -1348,6 +1379,14 @@
"show-project-settings": "プロジェクト設定を表示",
"show-version-control-tab": "バージョンコントロールタブを表示",
"start-flows": "フローを開始",
- "stop-flows": "フローを停止"
+ "stop-flows": "フローを停止",
+ "copy-item-url": "要素のURLをコピー",
+ "copy-item-edit-url": "要素の編集URLをコピー",
+ "move-flow-to-start": "フローを先頭に移動",
+ "move-flow-to-end": "フローを末尾に移動",
+ "show-global-env": "大域環境変数を表示",
+ "lock-flow": "フローを固定",
+ "unlock-flow": "フローの固定を解除",
+ "show-node-help": "ノードのヘルプを表示"
}
}
diff --git a/packages/node_modules/@node-red/editor-client/locales/ko/editor.json b/packages/node_modules/@node-red/editor-client/locales/ko/editor.json
old mode 100755
new mode 100644
index 9890dda9a..3c3160086
--- a/packages/node_modules/@node-red/editor-client/locales/ko/editor.json
+++ b/packages/node_modules/@node-red/editor-client/locales/ko/editor.json
@@ -24,16 +24,29 @@
"delete": "정말로 '__label__' 을(를) 삭제하시겠습니까?",
"dropFlowHere": "플로우를 이곳에 가져오세요",
"addFlow": "플로우 추가",
+ "addFlowToRight": "오른쪽에 플로우 추가",
+ "hideFlow": "플로우 숨기기",
+ "hideOtherFlows": "다른 플로우 숨기기",
+ "showAllFlows": "모든 플로우 보기",
+ "hideAllFlows": "모든 플로우 숨기기",
+ "hiddenFlows": "__count__개의 숨겨진 플로우 보기",
+ "hiddenFlows_plural": "__count__개의 숨겨진 플로우 보기",
+ "showLastHiddenFlow": "마지막으로 숨겨진 플로우 보기",
+ "listFlows": "플로우 리스트",
+ "listSubflows": "서브 플로우 리스트",
"status": "상태",
"enabled": "사용가능",
"disabled": "사용불가능",
- "info": "상세내역"
+ "info": "상세내역",
+ "selectNodes": "선택할 노드 클릭"
},
"menu": {
"label": {
"view": {
"view": "창",
"grid": "눈금선",
+ "storeZoom": "불러오기 시 확대/축소 복원",
+ "storePosition": "불러오기 시 스크롤 위치 복원",
"showGrid": "눈금선 보이기",
"snapGrid": "노드 배치 보조 켜기",
"gridSize": "눈금선 크기",
@@ -41,7 +54,9 @@
"defaultDir": "기본",
"ltr": "왼쪽 -> 오른쪽",
"rtl": "오른쪽 -> 왼쪽",
- "auto": "자동배분"
+ "auto": "자동배분",
+ "language": "언어",
+ "browserDefault": "브라우저 기본값"
},
"sidebar": {
"show": "우측사이드바 보이기"
@@ -49,18 +64,19 @@
"palette": {
"show": "팔렛트 보이기"
},
+ "edit": "수정",
"settings": "설정",
"userSettings": "사용자 설정",
"nodes": "노드설정",
- "displayStatus": "노드상태 보이기",
- "displayConfig": "설정노드 보기",
+ "displayStatus": "노드 상태 보이기",
+ "displayConfig": "설정 노드 보기",
"import": "가져오기",
"export": "내보내기",
"search": "플로우 검색",
"searchInput": "플로우 검색",
- "subflows": "보조 플로우",
- "createSubflow": "보조 플로우 생성",
- "selectionToSubflow": "보조 플로우 선택",
+ "subflows": "서브 플로우",
+ "createSubflow": "서브 플로우 생성",
+ "selectionToSubflow": "서브 플로우 선택",
"flows": "플로우",
"add": "추가",
"rename": "이름변경",
@@ -71,19 +87,43 @@
"editPalette": "팔렛트 관리",
"other": "기타",
"showTips": "Tip 보기",
+ "showWelcomeTours": "새 버전에 대한 가이드 보기 표시",
"help": "Node-RED 웹사이트",
"projects": "프로젝트",
"projects-new": "신규",
"projects-open": "열기",
"projects-settings": "프로젝트 설정",
- "showNodeLabelDefault": "새로 추가된 노드의 라벨 보이기"
+ "showNodeLabelDefault": "새로 추가된 노드의 라벨 보이기",
+ "codeEditor": "Code Editor",
+ "groups": "그룹",
+ "groupSelection": "그룹 선택",
+ "ungroupSelection": "그룹 선택 해제",
+ "groupMergeSelection": "선택 항목 병합",
+ "groupRemoveSelection": "선택 그룹 제거",
+ "arrange": "배치",
+ "alignLeft": "왼쪽으로 정렬",
+ "alignCenter": "가운데 정렬",
+ "alignRight": "오른쪽으로 정렬",
+ "alignTop": "맨 위에 정렬",
+ "alignMiddle": "맨 위에 정렬",
+ "alignBottom": "맨 아래 정렬",
+ "distributeHorizontally": "수평으로 배치",
+ "distributeVertically": "수직으로 배치",
+ "moveToBack": "맨 뒤로 이동",
+ "moveToFront": "맨 앞으로 이동",
+ "moveBackwards": "뒤로 이동",
+ "moveForwards": "앞으로 이동"
}
},
"actions": {
"toggle-navigator": "네비게이터 표시/비표시",
"zoom-out": "축소하기",
"zoom-reset": "확대/축소 초기화",
- "zoom-in": "확대하기"
+ "zoom-in": "확대하기",
+ "search-flows": "플로우 찾기",
+ "search-prev": "이전",
+ "search-next": "다음",
+ "search-counter": "\"__term__\" __result__ of __count__"
},
"user": {
"loggedInAs": "__name__ 에 로그인됨",
@@ -99,12 +139,17 @@
}
},
"notification": {
+ "state": {
+ "flowsStopped": "플로우 중지됨",
+ "flowsStarted": "플로우 시작됨"
+ },
"warning": "경고: __message__",
"warnings": {
"undeployedChanges": "변경사항 배포가 취소되었습니다",
"nodeActionDisabled": "노드 실행이 비활성화 되었습니다",
"nodeActionDisabledSubflow": "보조 플로우에서 노드 실행이 비활성화 되었습니다",
"missing-types": "
Verifique o console do navegador para obter mais informações
",
+ "installFailed": "
Falha ao instalar: __module__
__message__
Verifique o log para obter mais informações
",
+ "removeFailed": "
Falha ao remover: __module__
__message__
Verifique o log para obter mais informações
",
+ "updateFailed": "
Falha ao atualizar: __module__
__message__
Verifique o log para obter mais informações
",
+ "enableFailed": "
Falha ao ativar: __module__
__message__
Verifique o log para obter mais informações
",
+ "disableFailed": "
Falha ao desativar: __module__
__message__
Verifique o log para obter mais informações
"
+ },
+ "confirm": {
+ "install": {
+ "body": "
Instalando '__module__'
Antes de instalar, leia a documentação do nó. Alguns nós têm dependências que não podem ser resolvidas automaticamente e podem exigir a reinicialização do Node-RED.
Atualizar o nó exigirá a reinicialização do Node-RED para concluir a atualização. Isso deve ser feito manualmente.
",
+ "title": "Atualizar nós"
+ },
+ "cannotUpdate": {
+ "body": "Uma atualização para este nó está disponível, mas não está instalada em um local que o gerenciador de paletas possa atualizar.
Consulte a documentação para saber como atualizar este nó."
+ },
+ "button": {
+ "review": "Abrir informação do nó",
+ "install": "Instalar",
+ "remove": "Remover",
+ "update": "Atualizar"
+ }
+ }
+ }
+ },
+ "sidebar": {
+ "info": {
+ "name": "Informação",
+ "tabName": "Nome",
+ "label": "informações",
+ "node": "Nó",
+ "type": "Tipo",
+ "group": "Grupo",
+ "module": "Módulo",
+ "id": "ID",
+ "status": "Estado",
+ "enabled": "Habilitado",
+ "disabled": "Desabilitado",
+ "subflow": "Subfluxo",
+ "instances": "Instâncias",
+ "properties": "Propriedades",
+ "info": "Informação",
+ "desc": "Descrição",
+ "blank": "branco",
+ "null": "nulo",
+ "showMore": "mostrar mais",
+ "showLess": "mostrar menos",
+ "flow": "Fluxo",
+ "selection": "Seleção",
+ "nodes": "__count__ nós",
+ "flowDesc": "Descrição do Fluxo",
+ "subflowDesc": "Descrição do Subfluxo",
+ "nodeHelp": "Ajuda do Nó",
+ "none": "Nenhum",
+ "arrayItems": "__count__ items",
+ "showTips": "Você pode abrir as dicas a partir do painel de configurações",
+ "outline": "Contorno",
+ "empty": "vazio",
+ "globalConfig": "Nós de configuração global",
+ "triggerAction": "Ação de gatilho",
+ "find": "Encontre no espaço de trabalho"
+ },
+ "help": {
+ "name": "Ajuda",
+ "label": "ajuda",
+ "search": "Ajuda sobre a procura",
+ "nodeHelp": "Ajuda sobre o nó",
+ "showHelp": "Mostrar ajuda",
+ "showInOutline": "Mostrar no contorno",
+ "showTopics": "Mostrar tópicos",
+ "noHelp": "Nenhum tópico de ajuda selecionado",
+ "changeLog": "Log de alteração"
+ },
+ "config": {
+ "name": "Configuração dos nós",
+ "label": "configuração",
+ "global": "Em todos os fluxos",
+ "none": "nenhum",
+ "subflows": "subfluxos",
+ "flows": "fluxos",
+ "filterAll": "todos",
+ "showAllConfigNodes": "Ver todas as configurações dos nós",
+ "filterUnused": "não utilizados",
+ "showAllUnusedConfigNodes": "Mostrar todas os nós de configuração não usados",
+ "filtered": "__count__ hidden"
+ },
+ "context": {
+ "name": "Contexto dos Dados",
+ "label": "contexto",
+ "none": "nenhum selecionado",
+ "refresh": "atualize para carregar",
+ "empty": "vazio",
+ "node": "Nó",
+ "flow": "Fluxo",
+ "global": "Global",
+ "deleteConfirm": "Você tem certeza que deseja remover este item?",
+ "autoRefresh": "Atualizar na mudança de seleção",
+ "refrsh": "Atualizar",
+ "delete": "Remover"
+ },
+ "palette": {
+ "name": "Gerenciamento de paleta",
+ "label": "paleta"
+ },
+ "project": {
+ "label": "projeto",
+ "name": "Projeto",
+ "description": "Descrição",
+ "dependencies": "Dependências",
+ "settings": "Configurações",
+ "noSummaryAvailable": "Nenhum resumo disponível",
+ "editDescription": "Editar a descrição do projeto",
+ "editDependencies": "Editar dependências do projeto",
+ "noDescriptionAvailable": "Descrição não disponível",
+ "editReadme": "Editar README.md",
+ "showProjectSettings": "Mostrar configurações do projeto",
+ "projectSettings": {
+ "title": "Configurações do Projeto",
+ "edit": "editar",
+ "none": "Nenhum",
+ "install": "instalar",
+ "removeFromProject": "remover do projeto",
+ "addToProject": "adicionar ao projeto",
+ "files": "Arquivos",
+ "flow": "Fluxos",
+ "credentials": "Credenciais",
+ "package": "Pacote",
+ "packageCreate": "O arquivo será criado quando as alterações forem salvas",
+ "fileNotExist": "Arquivo não existe",
+ "selectFile": "Selecione o arquivo",
+ "invalidEncryptionKey": "Chave de criptografia inválida",
+ "encryptionEnabled": "Criptografia habilitada",
+ "encryptionDisabled": "Criptografia desabilitada",
+ "setTheEncryptionKey": "Defina a chave de criptografia",
+ "resetTheEncryptionKey": "Redefina a chave de criptografia",
+ "changeTheEncryptionKey": "Troque a chave de criptografia",
+ "currentKey": "Chave atual",
+ "newKey": "Nova chave",
+ "credentialsAlert": "Isso excluirá todas as credenciais existentes",
+ "versionControl": "Controle de versão",
+ "branches": "Ramos",
+ "noBranches": "Sem ramos",
+ "deleteConfirm": "Tem certeza de que deseja excluir o ramo local '__name__'? Isto não pode ser desfeito.",
+ "unmergedConfirm": "O ramo local '__name__' tem alterações não mescladas que serão perdidas. Tem certeza que deseja excluir?",
+ "deleteUnmergedBranch": "Excluir ramo não mesclado",
+ "gitRemotes": "Git remoto",
+ "addRemote": "adicionar remoto",
+ "addRemote2": "Adicionar remoto",
+ "remoteName": "Nome do remoto",
+ "nameRule": "Deve conter apenas A-Z 0-9 _ -",
+ "url": "URL",
+ "urlRule": "https://, ssh:// ou file://",
+ "urlRule2": "Não inclua o nome de usuário / senha na URL",
+ "noRemotes": "Sem remotos",
+ "deleteRemoteConfrim": "Tem certeza de que deseja excluir o remoto '__name__'?",
+ "deleteRemote": "Excluir remoto"
+ },
+ "userSettings": {
+ "committerDetail": "Detalhes do Cometedor",
+ "committerTip": "Deixe em branco para usar o padrão do sistema",
+ "userName": "Nome de usuário",
+ "email": "Email",
+ "workflow": "Fluxo de trabalho",
+ "workfowTip": "Escolha seu fluxo de trabalho git preferido",
+ "workflowManual": "Manual",
+ "workflowManualTip": "Todas as alterações devem ser confirmadas manualmente na barra lateral 'histórico'",
+ "workflowAuto": "Automático",
+ "workflowAutoTip": "As alterações são confirmadas automaticamente a cada implantação",
+ "sshKeys": "Chaves SSH",
+ "sshKeysTip": "Permite que você crie conexões seguras para repositórios git remotos.",
+ "add": "adicionar chave",
+ "addSshKey": "Adicionar chave SSH",
+ "addSshKeyTip": "Gerar um novo par de chaves públicas / privadas",
+ "name": "Nome",
+ "nameRule": "Deve conter apenas A-Z 0-9 _ -",
+ "passphrase": "Frase de passe",
+ "passphraseShort": "Frase de passe muito curta",
+ "optional": "Opcional",
+ "cancel": "Cancelar",
+ "generate": "Gerar chave",
+ "noSshKeys": "Sem chaves SSH",
+ "copyPublicKey": "Copiar chave pública para a área de transferência",
+ "delete": "Excluir chave key",
+ "gitConfig": "Configuração do Git",
+ "deleteConfirm": "Tem certeza de que deseja excluir a chave SSH __name__? Isso não pode ser desfeito."
+ },
+ "versionControl": {
+ "unstagedChanges": "Alterações não realizadas",
+ "stagedChanges": "Alterações realizadas",
+ "unstageChange": "Desfazer alteração",
+ "stageChange": "Realizar alteração",
+ "unstageAllChange": "Desfazer todas as alterações",
+ "stageAllChange": "Realizar todas as alterações",
+ "commitChanges": "Cometer alterações",
+ "resolveConflicts": "Resolver conflitos",
+ "head": "CABEÇA",
+ "staged": "Alterado",
+ "unstaged": "Desfeita Alteração",
+ "local": "Local",
+ "remote": "Remoto",
+ "revert": "Tem certeza de que deseja reverter as alterações para '__file__'? Essa ação não poderá ser desfeita.",
+ "revertChanges": "Reverter alterações",
+ "localChanges": "Mudanças locais",
+ "none": "Nenhum",
+ "conflictResolve": "Todos os conflitos resolvidos. Cometa as alterações para concluir a mesclagem.",
+ "localFiles": "Arquivos locais",
+ "all": "todos",
+ "unmergedChanges": "Alterações não mescladas",
+ "abortMerge": "interromper mesclagem",
+ "commit": "cometer",
+ "changeToCommit": "Alterações para cometer",
+ "commitPlaceholder": "Digite sua mensagem de cometimento",
+ "cancelCapital": "Cancelar",
+ "commitCapital": "Cometer",
+ "commitHistory": "Histórico do cometimento",
+ "branch": "Ramo:",
+ "moreCommits": "mais cometimentos",
+ "changeLocalBranch": "Alterar ramo local",
+ "createBranchPlaceholder": "Encontrar ou criar um ramo",
+ "upstream": "subir do cliente ao servidor",
+ "localOverwrite": "Você tem alterações locais que seriam sobrescritas alterando o ramo. Você deve cometer ou desfazer essas alterações primeiro.",
+ "manageRemoteBranch": "Gerenciar ramo remoto",
+ "unableToAccess": "Incapaz de acessar o repositório remoto",
+ "retry": "Tentar novamente",
+ "setUpstreamBranch": "Definir como ramo de subida do cliente para o servidor",
+ "createRemoteBranchPlaceholder": "Encontrar ou criar um ramo remoto",
+ "trackedUpstreamBranch": "O ramo criado será definido como o ramo de subida do cliente para o servidor rastreado.",
+ "selectUpstreamBranch": "O ramo será criado. Selecione abaixo para defini-lo como o ramo de subida do cliente para o servidor rastreado.",
+ "pushFailed": "falha ao empurrar porque o remoto tem cometimentos mais recentes. Puxe e mescle primeiro, depois empurre novamente.",
+ "push": "empurrar",
+ "pull": "puxar",
+ "unablePull": "
Incapaz de puxar as alterações remotas; suas alterações locais não realizadas seriam sobrescritas.
Cometa suas alterações e tente novamente.
",
+ "showUnstagedChanges": "Mostrar alterações não realizadas",
+ "connectionFailed": "Não foi possível conectar ao repositório remoto:",
+ "pullUnrelatedHistory": "
O remoto tem um histórico não relacionado de cometimentos.
Tem certeza que deseja puxar as mudanças para o seu repositório local?
",
+ "pullChanges": "Puxar modificações",
+ "history": "histórico",
+ "projectHistory": "Histórico do Projeto",
+ "daysAgo": "__count__ dia atrás",
+ "daysAgo_plural": "__count__ dias atrás",
+ "hoursAgo": "__count__ hora atrás",
+ "hoursAgo_plural": "__count__ horas atrás",
+ "minsAgo": "__count__ min ago",
+ "minsAgo_plural": "__count__ minutos atrás",
+ "secondsAgo": "Segundos atrás",
+ "notTracking": "Seu ramo local não está atualmente rastreando um ramo remoto.",
+ "statusUnmergedChanged": "Seu repositório tem alterações não mescladas. Você precisa corrigir os conflitos e enviar o resultado.",
+ "repositoryUpToDate": "Seu repositório está atualizado.",
+ "commitsAhead": "Seu repositório está __count__ cometimento à frente do remoto. Você pode empurrar este cometimento agora.",
+ "commitsAhead_plural": "Seu repositório está __count__ cometimentos à frente do remoto. Você pode empurrar estes cometimentos agora.",
+ "commitsBehind": "Seu repositório está __count__ cometimento atrás do remoto. Você pode puxar este cometimento agora.",
+ "commitsBehind_plural": "Seu repositório está __count__ cometimentos atrás do remoto. Você pode puxar esses cometimentos agora.",
+ "commitsAheadAndBehind1": "Seu repositório está __count__ cometimento atrás e",
+ "commitsAheadAndBehind1_plural": "Seu repositório está __count__ cometimentos atrás e",
+ "commitsAheadAndBehind2": "__count__ cometimento à frente do remoto.",
+ "commitsAheadAndBehind2_plural": "__count__ cometimentos à frente do remoto.",
+ "commitsAheadAndBehind3": "Você deve baixar o cometimento remoto antes de empurrar.",
+ "commitsAheadAndBehind3_plural": "Você deve baixar os cometimentos remotos antes de empurrar.",
+ "refreshCommitHistory": "Atualizar histórico de cometimentos",
+ "refreshChanges": "Atualizar alterações"
+ }
+ }
+ },
+ "typedInput": {
+ "type": {
+ "str": "cadeia de caracteres",
+ "num": "número",
+ "re": "expressão regular",
+ "bool": "booliano",
+ "json": "JSON",
+ "bin": "armazenamento temporário",
+ "date": "registro de tempo",
+ "jsonata": "expressão",
+ "env": "variável de ambiente",
+ "cred": "credencial"
+ }
+ },
+ "editableList": {
+ "add": "adicionar",
+ "addTitle": "adicionar um item"
+ },
+ "search": {
+ "history": "Histórico da procura",
+ "clear": "limpar tudo",
+ "empty": "Nenhuma equivalência encontrada",
+ "addNode": "adicionar um nó...",
+ "options": {
+ "configNodes": "Configuração de nós",
+ "unusedConfigNodes": "Configuração de nós não utilizadas",
+ "invalidNodes": "Nós inválidos",
+ "uknownNodes": "Nós desconhecidos",
+ "unusedSubflows": "Subfluxos não utilizados",
+ "hiddenFlows": "Flux escondidos",
+ "modifiedNodes": "Nós e Fluxos Modificados",
+ "thisFlow": "Fluxo atual"
+ }
+ },
+ "expressionEditor": {
+ "functions": "Funções",
+ "functionReference": "Referência de função",
+ "insert": "Inserir",
+ "title": "Editor de Expressões JSONata",
+ "test": "Teste",
+ "data": "Mensagem de exemplo",
+ "result": "Resultado",
+ "format": "expressão de formato",
+ "compatMode": "Modo de compatibilidade habilitado",
+ "compatModeDesc": "
Modo de compatibilidade JSONata
A expressão atual parece ainda fazer referência a msg , então será avaliada no modo de compatibilidade. Atualize a expressão para não usar msg , pois este modo será removido no futuro.
Quando o suporte JSONata foi adicionado pela primeira vez ao Node-RED, era necessária a expressão para fazer referência ao objeto msg . Por exemplo, msg.payload seria usado para acessar a carga útil.
Isso não é mais necessário, pois a expressão será avaliada em relação à mensagem diretamente. Para acessar a carga útil, a expressão deve ser apenas payload.
O tipo de armazenamento temporário é armazenado como uma matriz JSON de valores de bytes. O editor tentará analisar o valor inserido como uma matriz JSON. Se não for um JSON válido, será tratada como uma cadeia de caracteres UTF-8 e convertida em uma matriz de pontos de código de caractere individual.
Por exemplo, um valor de Hello World será convertido na matriz JSON:
"
+ },
+ "projects": {
+ "config-git": "Configurar cliente Git",
+ "welcome": {
+ "hello": "Olá! Introduzimos 'projetos' no Node-RED.",
+ "desc0": "Esta é uma nova maneira de gerenciar seus arquivos de fluxo e incluir controle de versão de seus fluxos.",
+ "desc1": "Para começar, você pode criar seu primeiro projeto ou clonar um projeto existente de um repositório git.",
+ "desc2": "Se você não tiver certeza, pode pular isso por enquanto. Você ainda poderá criar seu primeiro projeto a partir do menu 'Projetos' a qualquer momento.",
+ "create": "Criar Projeto",
+ "clone": "Repositório de clones",
+ "openExistingProject": "Abrir projeto existente",
+ "not-right-now": "Não nesse exato momento"
+ },
+ "git-config": {
+ "setup": "Configure seu cliente de controle de versão",
+ "desc0": "O Node-RED usa a ferramenta de código aberto Git para controle de versão. Ele rastreia as alterações em seus arquivos de projeto e permite enviá-los para repositórios remotos.",
+ "desc1": "Quando você confirma um conjunto de alterações, o Git registra quem fez as alterações com um nome de usuário e endereço de e-mail. O nome de usuário pode ser o que você quiser - não precisa ser seu nome real.",
+ "desc2": "Seu cliente Git já está configurado com os detalhes abaixo.",
+ "desc3": "Você pode alterar essas configurações mais tarde na guia 'Git config' da caixa de diálogo de configurações.",
+ "username": "Nome do usuário",
+ "email": "E-mail"
+ },
+ "project-details": {
+ "create": "Crie seu projeto",
+ "desc0": "Um projeto é mantido como um repositório Git. Isso torna muito mais fácil compartilhar seus fluxos com outras pessoas e colaborar neles.",
+ "desc1": "Você pode criar vários projetos e alternar rapidamente entre eles no editor.",
+ "desc2": "Para começar, seu projeto precisa de um nome e uma descrição opcional.",
+ "already-exists": "Projeto já existe",
+ "must-contain": "Deve conter apenas A-Z 0-9 _ -",
+ "project-name": "Nome do Projeto",
+ "desc": "Descrição",
+ "opt": "Opcional"
+ },
+ "clone-project": {
+ "clone": "Clonar um projeto",
+ "desc0": "Se você já tem um repositório git contendo um projeto, pode cloná-lo para começar.",
+ "already-exists": "Projeto já existe",
+ "must-contain": "Deve conter apenas A-Z 0-9 _ -",
+ "project-name": "Nome do projeto",
+ "no-info-in-url": "Não inclua o nome de usuário / senha no url",
+ "git-url": "Git repository URL",
+ "protocols": "https: //, ssh: // ou file://",
+ "auth-failed": "Autenticação falhou",
+ "username": "Nome de usuário",
+ "passwd": "Senha",
+ "ssh-key": "Chave SSH",
+ "passphrase": "Frase de Passe",
+ "ssh-key-desc": "Antes de clonar um repositório usando ssh, você deve adicionar uma chave SSH para acessá-lo.",
+ "ssh-key-add": "Adicionar uma chave ssh",
+ "credential-key": "Chave de criptografia de credenciais",
+ "cant-get-ssh-key": "Erro! Não é possível obter o caminho da chave SSH selecionada.",
+ "already-exists2": "já existe",
+ "git-error": "git error",
+ "connection-failed": "Conexão falhou",
+ "not-git-repo": "Não é um repositório git",
+ "repo-not-found": "Repositório não encontrado"
+ },
+ "default-files": {
+ "create": "Crie seus arquivos de projeto",
+ "desc0": "Um projeto contém seus arquivos de fluxo, um arquivo README e um arquivo package.json.",
+ "desc1": "Pode conter quaisquer outros arquivos que você deseja manter no repositório Git.",
+ "desc2": "Seus arquivos de fluxo e credenciais existentes serão copiados para o projeto.",
+ "flow-file": "Arquivo de fluxo",
+ "credentials-file": "Arquivo de credenciais"
+ },
+ "encryption-config": {
+ "setup": "Configure a criptografia do seu arquivo de credenciais",
+ "desc0": "Seu arquivo de credenciais de fluxo pode ser criptografado para manter seu conteúdo seguro.",
+ "desc1": "Se você deseja armazenar essas credenciais em um repositório Git público, deve criptografá-las fornecendo uma frase-chave secreta.",
+ "desc2": "Seu arquivo de credenciais de fluxo não está criptografado no momento.",
+ "desc3": "Isso significa que seu conteúdo, como senhas e fichas de acesso, pode ser lido por qualquer pessoa com acesso ao arquivo.",
+ "desc4": "Se você deseja armazenar essas credenciais em um repositório Git público, deve criptografá-las fornecendo uma frase-chave secreta.",
+ "desc5": "Seu arquivo de credenciais de fluxo está atualmente criptografado usando a propriedade credentialSecret de seu arquivo de configurações como a chave.",
+ "desc6": "Seu arquivo de credenciais de fluxo está criptografado usando uma chave gerada pelo sistema. Você deve fornecer uma nova chave secreta para este projeto.",
+ "desc7": "A chave será armazenada separadamente dos arquivos do seu projeto. Você precisará fornecer a chave para usar este projeto em outra instância do Node-RED.",
+ "credentials": "Credenciais",
+ "enable": "Habilitar criptografia",
+ "disable": "Desabilitar criptografia",
+ "disabled": "desabilitado",
+ "copy": "Copiar sobre a chave existente",
+ "use-custom": "Usar chave personalizada",
+ "desc8": "O arquivo de credenciais não será criptografado e seu conteúdo será lido facilmente",
+ "create-project-files": "Criar arquivos de projeto",
+ "create-project": "Criar projeto",
+ "already-exists": "já existe",
+ "git-error": "erro no git",
+ "git-auth-error": "git erro de autenticação"
+ },
+ "create-success": {
+ "success": "Você criou com sucesso o seu primeiro projeto!",
+ "desc0": "Agora você pode continuar usando o Node-RED como sempre fez.",
+ "desc1": "A guia 'informações' na barra lateral mostra qual é o seu projeto ativo atual. O botão ao lado do nome pode ser usado para acessar a visualização das configurações do projeto.",
+ "desc2": "A guia 'histórico' na barra lateral pode ser usada para ver os arquivos que foram alterados no seu projeto e para submetê-los. Ela mostra um histórico completo de seus cometimentos e permite que você envie suas alterações para um repositório remoto . "
+ },
+ "create": {
+ "projects": "Projetos",
+ "already-exists": "Projeto já existe",
+ "must-contain": "Deve conter apenas A-Z 0-9 _ -",
+ "no-info-in-url": "Não inclua o nome de usuário/senha no url",
+ "open": "Abrir projeto",
+ "create": "Criar Projeto",
+ "clone": "Clone Repositório",
+ "project-name": "Nome do projeto",
+ "desc": "Descrição",
+ "opt": "Opcional",
+ "flow-file": "Arquivo de fluxo",
+ "credentials": "Credenciais",
+ "enable-encryption": "Habilitar criptografia",
+ "disable-encryption": "Desabilitar criptografia",
+ "encryption-key": "Chave de criptografia",
+ "desc0": "Uma frase para proteger suas credenciais com",
+ "desc1": "O arquivo de credenciais não será criptografado e seu conteúdo poderá ser lido facilmente",
+ "git-url": "URL do repositório Git",
+ "protocols": "https://, ssh:// or file://",
+ "auth-failed": "Falha na autenticação",
+ "username": "Nome do usuário",
+ "password": "Senha",
+ "ssh-key": "Chave SSH",
+ "passphrase": "Frase de Passe",
+ "desc2": "Antes de clonar um repositório usando ssh, você deve adicionar uma chave SSH para acessá-lo.",
+ "add-ssh-key": "Adicionar uma chave ssh",
+ "credentials-encryption-key": "Chave de criptografia de credenciais",
+ "already-exists-2": "já existe",
+ "git-error": "erro de git",
+ "con-failed": "Conexão falhou",
+ "not-git": "Não é um repositório git",
+ "no-resource": "Repositório não encontrado",
+ "cant-get-ssh-key-path": "Erro! Não é possível obter o caminho da chave SSH selecionado.",
+ "unexpected_error": "erro_inesperado",
+ "clearContext": "Limpar contexto quando ocorrer troca de projetos"
+ },
+ "delete": {
+ "confirm": "Tem certeza de que deseja excluir este projeto?"
+ },
+ "create-project-list": {
+ "search": "procure seus projetos",
+ "current": "atual"
+ },
+ "require-clean": {
+ "confirm": "
Você tem alterações não implantadas que serão perdidas.
Deseja continuar?
"
+ },
+ "send-req": {
+ "auth-req": "Autenticação necessária para repositório",
+ "username": "Nome do usuário",
+ "password": "Senha",
+ "passphrase": "Frase de Passe",
+ "retry": "Tentar novamente",
+ "update-failed": "Falha ao atualizar autenticação",
+ "unhandled": "Resposta de erro não tratada",
+ "host-key-verify-failed": "
Falha na verificação da chave do servidor anfitrião.
A chave do servidor anfitrião do repositório não pôde ser verificada. Atualize seu arquivo known_hosts e tente novamente.
"
+ },
+ "create-branch-list": {
+ "invalid": "Ramo inválido",
+ "create": "Criar ramo",
+ "current": "atual"
+ },
+ "create-default-file-set": {
+ "no-active": "Não é possível criar um conjunto de arquivos padrão sem um projeto ativo",
+ "no-empty": "Não é possível criar um arquivo padrão definido em um projeto não vazio",
+ "git-error": "erro no git"
+ },
+ "errors": {
+ "no-username-email": "Seu cliente Git não está configurado com um nome de usuário / e-mail.",
+ "unexpected": "Um erro inesperado ocorreu",
+ "code": "código"
+ }
+ },
+ "editor-tab": {
+ "properties": "Propriedades",
+ "envProperties": "Variáveis de Ambiente",
+ "module": "Propriedades do Módulo",
+ "description": "Descrição",
+ "appearance": "Aparência",
+ "preview": "Visualização da IU",
+ "defaultValue": "Valor padrão"
+ },
+ "tourGuide": {
+ "takeATour": "Faça um tour",
+ "start": "Inicio",
+ "next": "Próximo",
+ "welcomeTours": "Tour de Boas-vindas"
+ },
+ "diagnostics": {
+ "title": "informações do Sistema"
+ },
+ "languages": {
+ "de": "Alemão",
+ "en-US": "Inglês",
+ "ja": "Japonês",
+ "ko": "Coreano",
+ "pt-BR": "Português(Brasil)",
+ "ru": "Russo",
+ "zh-CN": "Chinês(Simplificado)",
+ "zh-TW": "Chinês(Tradicional)"
+ },
+ "validator": {
+ "errors": {
+ "invalid-json": "Dados JSON inválidos: __error__",
+ "invalid-json-prop": "__prop__: dados JSON inválidos: __error__",
+ "invalid-prop": "Expressão de propriedade inválida",
+ "invalid-prop-prop": "__prop__: expressão de propriedade inválida",
+ "invalid-num": "Número inválido",
+ "invalid-num-prop": "__prop__: número inválido",
+ "invalid-regexp": "Padrão de entrada inválido",
+ "invalid-regex-prop": "__prop__: Padrão de entrada inválido",
+ "missing-required-prop": "__prop__: valor de propriedade ausente",
+ "invalid-config": "__prop__: nó de configuração inválido",
+ "missing-config": "__prop__: nó de Configuração ausente",
+ "validation-error": "__prop__: erro de validação: __node__, __id__: __error__"
+ }
+ },
+ "contextMenu": {
+ "insert": "Inserir",
+ "node": "Nó",
+ "junction": "Junção",
+ "linkNodes": "Nós de Ligação"
+ }
+}
diff --git a/packages/node_modules/@node-red/editor-client/locales/pt-BR/infotips.json b/packages/node_modules/@node-red/editor-client/locales/pt-BR/infotips.json
new file mode 100755
index 000000000..7ac7502c1
--- /dev/null
+++ b/packages/node_modules/@node-red/editor-client/locales/pt-BR/infotips.json
@@ -0,0 +1,23 @@
+{
+ "info": {
+ "tip0": "Você pode remover os nós ou links selecionados com {{core:delete-selection}}",
+ "tip1": "Procure por nós usando {{core:search}}",
+ "tip2": "{{core:toggle-sidebar}} irá alternar a visualização desta barra lateral",
+ "tip3": "Você pode gerenciar sua paleta de nós com {{core:manage-palette}}",
+ "tip4": "Seus nós de configuração de fluxo são listados no painel da barra lateral. Pode ser acessado a partir do menu ou com{{core:show-config-tab}}",
+ "tip5": "Habilite ou desabilite essas dicas na opção nas configurações",
+ "tip6": "Mova os nós selecionados usando o [left] [up] [down] e [right] chaves. Segure [shift] para empurrá-los ainda mais",
+ "tip7": "Arrastar um nó para um fio o unirá no link",
+ "tip8": "Exporte os nós selecionados ou a guia atual com {{core:show-export-dialog}}",
+ "tip9": "Importe um fluxo arrastando seu JSON para o editor ou com {{core:show-import-dialog}}",
+ "tip10": "[shift] [click] e arraste em uma porta de nó para mover todos os fios conectados ou apenas o selecionado",
+ "tip11": "Mostre a guia Informações com {{core:show-info-tab}} ou a guia Depurar com {{core:show-debug-tab}}",
+ "tip12": "[ctrl] [click] na área de trabalho para abrir a caixa de diálogo de adição rápida",
+ "tip13": "Mantenha pressionado [ctrl] enquanto você [click] em uma porta de nó para habilitar a ligação rápida",
+ "tip14": "Mantenha pressionado [shift] enquanto você [click] em um nó para também selecionar todos os seus nós conectados",
+ "tip15": "Mantenha pressionado [ctrl] enquanto você [click] em um nó para adicioná-lo ou removê-lo da seleção atual",
+ "tip16": "Alternar guias de fluxo com {{core:show-previous-tab}} e {{core:show-next-tab}}",
+ "tip17": "Você pode confirmar suas alterações na bandeja de edição do nó com {{core:confirm-edit-tray}} ou cancele-os com {{core:cancel-edit-tray}}",
+ "tip18": "Pressionando {{core:edit-selected-node}} irá editar o primeiro nó na seleção atual"
+ }
+}
diff --git a/packages/node_modules/@node-red/editor-client/locales/pt-BR/jsonata.json b/packages/node_modules/@node-red/editor-client/locales/pt-BR/jsonata.json
new file mode 100755
index 000000000..18d0e78c1
--- /dev/null
+++ b/packages/node_modules/@node-red/editor-client/locales/pt-BR/jsonata.json
@@ -0,0 +1,274 @@
+{
+ "$string": {
+ "args": "arg[, prettify]",
+ "desc": "Converte o tipo do parâmetro `arg` em uma cadeia de caracteres usando as seguintes regras de conversão de tipo:\n\n - Cadeia de caracteres não são alteradas\n - As funções são convertidas para uma cadeia de caracteres vazia\n - os tipos numérico infinito e NaN geram um erro porque não podem ser representados como um número JSON\n - Todos os outros valores são convertidos para uma cadeia de caracteres JSON usando a função `JSON.stringify`. Se `prettify` for verdadeira, então o JSON \"prettified\" é produzido. Isto é, uma linha por campo e as linhas serão indentadas com base na profundidade do campo."
+ },
+ "$length": {
+ "args": "str",
+ "desc": "Retorna o número de caracteres na cadeia de caracteres `str`. Um erro é gerado se `str` não for uma cadeia de caracteres."
+ },
+ "$substring": {
+ "args": "str, start[, length]",
+ "desc": "Retorna uma cadeia de caracteres contendo os caracteres no primeiro parâmetro `str` começando na posição `start` (deslocamento zero). Se` length` for especificado, então a sub cadeia de caracteres conterá o máximo `length` de caracteres. Se` start` for negativo isso indica o número de caracteres a partir do fim de `str`."
+ },
+ "$substringBefore": {
+ "args": "str, chars",
+ "desc": "Retorna a sub cadeia de caracteres antes da primeira ocorrência da sequência de caracteres `chars` em `string`. Se` string` não contiver `chars`, então retorna `str`. "
+ },
+ "$substringAfter": {
+ "args": "str, chars",
+ "desc": "Retorna a sub cadeia de caracteres após a primeira ocorrência da sequência de caracteres `chars` em `string`. Se `string` não contiver `chars`, então retorna `str`. "
+ },
+ "$uppercase": {
+ "args": "str",
+ "desc": "Retorna uma cadeia de caracteres com todos os caracteres de `string` convertidos em maiúsculas. "
+ },
+ "$lowercase": {
+ "args": "str",
+ "desc": "Retorna uma cadeia de caracteres com todos os caracteres de `string` convertidos em minúsculas. "
+ },
+ "$trim": {
+ "args": "str",
+ "desc": "Normaliza e retira todos os caracteres de espaço em branco em `str` aplicando as seguintes etapas:\n\n - Todas as tabulações, retornos de carro e avanços de linha são substituídos por espaços.\n- Sequências contíguas de espaços são reduzidas a um único espaço.\n- Espaços à direita e à esquerda são removidos.\n\n Se `str` não for especificado (isto é, esta função é chamada sem argumentos), então o valor do contexto é usado como o valor de `str`. Um erro é gerado se `str` não for uma cadeia de caracteres."
+ },
+ "$contains": {
+ "args": "str, pattern",
+ "desc": "Retorna `true` se `str` tiver correspondente em `pattern`, caso contrário, retorna `false`. Se `str` não for especificado (isto é, esta função é chamada com um argumento), então o valor do contexto é usado como o valor de `str`. O parâmetro `pattern` pode ser uma cadeia de caracteres ou uma expressão regular. "
+ },
+ "$split": {
+ "args": "str[, separator][, limit]",
+ "desc": "Divide o parâmetro `str` em uma matriz de sub cadeia de caracteres. É um erro se `str` não for uma cadeia de caracteres. O parâmetro opcional `separator` especifica os caracteres dentro de `str` sobre os quais devem ser divididos como uma cadeia de caracteres ou expressão regular. Se `separator` não for especificado, a cadeia de caracteres vazia será assumida e `str` será dividido em uma matriz de caracteres únicos. É um erro se `separador` não for uma cadeia de caracteres. O parâmetro opcional `limit` é um número que especifica o número máximo de sub cadeia de caracteres a serem incluídas na matriz resultante. Quaisquer sub cadeia de caracteres adicionais são descartadas. Se `limit` não for especificado, então `str` será totalmente dividido sem limite para o tamanho da matriz resultante . É um erro se `limit` não for um número não negativo."
+ },
+ "$join": {
+ "args": "array[, separator]",
+ "desc": "Une uma matriz de cadeias de caracteres de componentes em uma única cadeia de caracteres concatenada com cada cadeia de caracteres de componente separada pelo parâmetro opcional `separator`. É um erro se a `matriz` de entrada contiver um item que não seja uma cadeia de caracteres. Se `separator` for não especificado, assume-se que é uma cadeia de caracteres vazia, ou seja, nenhum `separator` entre as cadeias de caracteres do componente. É um erro se `separator` não for uma cadeia de caracteres. "
+ },
+ "$match": {
+ "args": "str, pattern [, limit]",
+ "desc": "Aplica a cadeia de caracteres `str` à expressão regular `pattern` e retorna uma matriz de objetos, com cada objeto contendo informações sobre cada ocorrência de uma correspondência dentro de `str`. "
+ },
+ "$replace": {
+ "args": "str, pattern, replacement [, limit]",
+ "desc": "Encontra ocorrências de `pattern` dentro de `str` e as substitui por `replacement`.\n\nO parâmetro opcional `limit` é o número máximo de substituições."
+ },
+ "$now": {
+ "args":"$[picture [, timezone]]",
+ "desc":"Gera um carimbo de data/hora em formato compatível com ISO 8601 e o retorna como uma cadeia de caracteres. Se os parâmetros opcionais de imagem e fuso horário forem fornecidos, o carimbo de data/hora atual é formatado conforme descrito pela função `$ fromMillis ()`"
+ },
+ "$base64encode": {
+ "args":"string",
+ "desc":"Converte uma cadeia de caracteres ASCII em uma representação de base 64. Cada caractere na cadeia de caracteres é tratado como um byte de dados binários. Isso requer que todos os caracteres na cadeia de caracteres estejam no intervalo de 0x00 a 0xFF, o que inclui todos os caracteres em cadeias de caracteres codificadas em URI. Caracteres Unicode fora desse intervalo não são suportados."
+ },
+ "$base64decode": {
+ "args":"string",
+ "desc":"Converte bytes codificados de base 64 em uma cadeia de caracteres, usando uma página de código UTF-8 Unicode."
+ },
+ "$number": {
+ "args": "arg",
+ "desc": "Converte o parâmetro `arg` em um número usando as seguintes regras de conversão:\n\n - Os números permanecem inalterados\n - Cadeias de caracteres que contêm uma sequência de caracteres que representam um número JSON válido são convertidos para esse número\n - Todos os outros valores causam a geração de um erro."
+ },
+ "$abs": {
+ "args":"number",
+ "desc":"Retorna o valor absoluto do parâmetro `number`."
+ },
+ "$floor": {
+ "args":"number",
+ "desc":"Retorna o valor de `number` arredondado para baixo para o inteiro mais próximo que seja menor ou igual a `number`."
+ },
+ "$ceil": {
+ "args":"number",
+ "desc":"Retorna o valor de `number` arredondado para o número inteiro mais próximo que é maior ou igual a `number`."
+ },
+ "$round": {
+ "args":"number [, precision]",
+ "desc":"Retorna o valor do parâmetro `number` arredondado para o número de casas decimais especificado pelo parâmetro opcional `precision`."
+ },
+ "$power": {
+ "args":"base, exponent",
+ "desc":"Retorna o valor de `base` elevado à potência de `exponent`."
+ },
+ "$sqrt": {
+ "args":"number",
+ "desc":"Retorna a raiz quadrada do valor do parâmetro `number`."
+ },
+ "$random": {
+ "args":"",
+ "desc":"Retorna um número pseudoaleatório maior ou igual a zero e menor que um."
+ },
+ "$millis": {
+ "args":"",
+ "desc":"Retorna o número de milissegundos desde o Unix Epoch (1º de janeiro de 1970 UTC) como um número. Todas as invocações de `$ millis ()` dentro de uma avaliação de uma expressão retornarão todas o mesmo valor."
+ },
+ "$sum": {
+ "args": "array",
+ "desc": "Retorna a soma aritmética de uma `array` de números. É um erro se o `array` de entrada contiver um item que não seja um número."
+ },
+ "$max": {
+ "args": "array",
+ "desc": "Retorna o número máximo em uma `array` de números. É um erro se o `array` de entrada contiver um item que não seja um número."
+ },
+ "$min": {
+ "args": "array",
+ "desc": "Retorna o número mínimo em uma `array` de números. É um erro se o `array` de entrada contiver um item que não seja um número."
+ },
+ "$average": {
+ "args": "array",
+ "desc": "Retorna o valor médio de uma `array` de números. É um erro se o `array` de entrada contiver um item que não seja um número."
+ },
+ "$boolean": {
+ "args": "arg",
+ "desc": "Converte o argumento em um booliano usando as seguintes regras:\n\n - `Boolean` : inalterado\n - `string`: vazio : `false`\n - `string`: não-vazio : `true`\n - `number`: `0` : `false`\n - `number`: não-zero : `true`\n - `null` : `false`\n - `array`: vazio : `false`\n - `array`: contém um membro que converte de tipo para `true` : `true`\n - `array`: todos os membros convertidos de tipo para `false` : `false`\n - `object`: vazio : `false`\n - `object`: não-vazio : `true`\n - `function` : `false`"
+ },
+ "$not": {
+ "args": "arg",
+ "desc": "Retorna booliano NOT no argumento. `Arg` é convertido de tipo primeiro para um booliano "
+ },
+ "$exists": {
+ "args": "arg",
+ "desc": "Retorna booliano `true` se a expressão `arg` for avaliada como um valor, ou `false` se a expressão não corresponder a nada (por exemplo, um caminho para uma referência de campo inexistente)."
+ },
+ "$count": {
+ "args": "array",
+ "desc": "Retorna o número de itens na matriz"
+ },
+ "$append": {
+ "args": "array, array",
+ "desc": "Anexa duas matrizes"
+ },
+ "$sort": {
+ "args":"array [, function]",
+ "desc":"Retorna uma matriz contendo todos os valores no parâmetro `array`, mas classificados em ordem.\n\nSe um comparador `function` for fornecido, então deve ser uma função que leva dois parâmetros:\n\n`function(left, right)`\n\nEsta função é invocada pelo algoritmo de classificação para comparar dois valores à esquerda e à direita. Se o valor de esquerda deve ser colocado após o valor de direita na ordem de classificação desejada, a função deve retornar o booliano `true` para indicar uma troca. Caso contrário, deve retornar `false`."
+ },
+ "$reverse": {
+ "args":"array",
+ "desc":"Retorna uma matriz contendo todos os valores do parâmetro `array`, mas na ordem reversa. "
+ },
+ "$shuffle": {
+ "args":"array",
+ "desc":"Retorna uma matriz contendo todos os valores do parâmetro `array`, mas misturados em ordem aleatória. "
+ },
+ "$zip": {
+ "args":"array, ...",
+ "desc":"Retorna uma matriz convolucional (compactada) contendo matrizes agrupadas de valores dos argumentos `array1`… `arrayN` do índice 0, 1, 2 ...."
+ },
+ "$keys": {
+ "args": "object",
+ "desc": "Retorna uma matriz contendo as chaves do objeto. Se o argumento for uma matriz de objetos, então a matriz retornada contém uma lista não duplicada de todas as chaves em todos os objetos."
+ },
+ "$lookup": {
+ "args": "object, key",
+ "desc": "Retorna o valor associado à chave no objeto. Se o primeiro argumento for uma matriz de objetos, todos os objetos na matriz são pesquisados e os valores associados a todas as ocorrências da chave são retornados."
+ },
+ "$spread": {
+ "args": "object",
+ "desc": "Divide um objeto que contém pares de chave/valor em uma matriz de objetos, cada um com um único par de chave/valor do objeto de entrada. Se o parâmetro for uma matriz de objetos, a matriz resultante conterá um objeto para cada par de chave/valor em todo objeto na matriz fornecida. "
+ },
+ "$merge": {
+ "args": "array<object>",
+ "desc": "Mescla uma matriz de `objects` em um único `object` contendo todos os pares de chave/valor de cada um dos objetos na matriz de entrada. Se qualquer um dos objetos de entrada contiver a mesma chave, então o `object` retornado conterá o valor do último na matriz. É um erro se a matriz de entrada contiver um item que não seja um objeto."
+ },
+ "$sift": {
+ "args":"object, function",
+ "desc": "Retorna um objeto que contém apenas os pares de chave/valor do parâmetro `object` que satisfazem o predicado `function` passado como o segundo parâmetro.\n\nA `function` que é fornecida como o segundo parâmetro deve ter o seguinte assinatura:\n\n`function(value [, key [, object]])`"
+ },
+ "$each": {
+ "args":"object, function",
+ "desc":"Retorna uma matriz contendo os valores retornados por `function` quando aplicado a cada par chave/valor no `object`."
+ },
+ "$map": {
+ "args":"array, function",
+ "desc":"Retorna uma matriz contendo os resultados da aplicação do parâmetro `function` a cada valor no parâmetro `array`.\n\nA `function` que é fornecido como o segundo parâmetro deve ter a seguinte assinatura:\n\n`function(value [, index [, array]])`"
+ },
+ "$filter": {
+ "args":"array, function",
+ "desc":"Retorna uma matriz contendo apenas os valores no parâmetro `array` que satisfazem o predicado `function`.\n\nThe `function` que é fornecido como o segundo parâmetro deve ter a seguinte assinatura:\n\n`function(value [, index [, array]])`"
+ },
+ "$reduce": {
+ "args":"array, function [, init]",
+ "desc":"Retorna um valor agregado derivado da aplicação do parâmetro `function` sucessivamente a cada valor em `array` em combinação com o resultado da aplicação anterior da função.\n\nA função deve aceitar dois argumentos e se comportar como um operador inserido entre cada valor dentro de `array`. A assinatura da `function` deve estar no formato: `myfunc($accumulator, $value[, $index[, $array]])`\n\nO parâmetro opcional `init` é usado como o valor inicial na agregação."
+ },
+ "$flowContext": {
+ "args": "string[, string]",
+ "desc": "Recupera uma propriedade de contexto de fluxo.\n\nEsta é uma função definida pelo Node-RED. "
+ },
+ "$globalContext": {
+ "args": "string[, string]",
+ "desc": "Recupera uma propriedade de contexto global.\n\nEsta é uma função definida pelo Node-RED. "
+ },
+ "$pad": {
+ "args": "string, width [, char]",
+ "desc": "Retorna uma cópia da `string` com preenchimento extra, se necessário, de forma que seu número total de caracteres seja pelo menos o valor absoluto do parâmetro `width`.\n\nSe `width` for um número positivo, a cadeia de caracteres será preenchida à direita; se negativo, é preenchida à esquerda.\n\nO argumento opcional `char` especifica os caracteres de preenchimento a serem usados. Se não for especificado, o padrão é o caractere de espaço. "
+ },
+ "$fromMillis": {
+ "args": "number, [, picture [, timezone]]",
+ "desc": "Converta o `number` que representa os milissegundos desde a época do Unix (1 January, 1970 UTC) em uma representação de cadeia de caracteres formatada do carimbo de data/hora conforme especificado pela cadeia de caracteres de imagem.\n\nSe o parâmetro opcional `image` for omitido, o carimbo de data/hora será formatado no formato ISO 8601.\n\nSe a cadeia de caracteresopcional `picture` for fornecida, o carimbo de data/hora é formatado de acordo com a representação especificada nessa cadeia de caracteres. O comportamento desta função é consistente com a versão de dois argumentos da função XPath/XQuery `format-dateTime` conforme definido na especificação XPath F&O 3.1. O parâmetro de cadeia de caracteres de imagem define como o carimbo de data/hora é formatado e tem a mesma sintaxe de `format-dateTime`.\n\nSe a cadeia de caracteres opcional `timezone` for fornecida, o carimbo de data/hora formatado estará nesse fuso horário. A cadeia de caracteres `timezone` deve estar no formato '± HHMM', onde ± é o sinal de mais ou menos e HHMM é o deslocamento em horas e minutos do UTC. Deslocamento positivo para fusos horários a leste do UTC, deslocamento negativo para fusos horários a oeste do UTC. "
+ },
+ "$formatNumber": {
+ "args": "number, picture [, options]",
+ "desc": "Converte o tipo de `number` em uma cadeia de caracteres e o formata em uma representação decimal conforme especificado pela cadeia de caracteres `picture`.\n\n O comportamento desta função é consistente com a função XPath/XQuery fn: format-number conforme definido na especificação XPath F&O 3.1. O parâmetro de cadeia de caracteres de imagem define como o número é formatado e tem a mesma sintaxe de fn: format-number.\n\nO terceiro argumento opcional `options` é usado para substituir os caracteres de formatação específicos da localidade padrão, como o separador decimal. Se fornecido, este argumento deve ser um objeto contendo pares de nome/valor especificados na seção de formato decimal da especificação XPath F&O 3.1."
+ },
+ "$formatBase": {
+ "args": "number [, radix]",
+ "desc": "Converte o `number` em uma cadeia de caracteres e o formata em um inteiro representado na base do número especificada pelo argumento `radix`. Se `radix` não for especificado, o padrão é a base 10. `radix` pode estar entre 2 e 36, caso contrário, um erro será gerado. "
+ },
+ "$toMillis": {
+ "args": "timestamp",
+ "desc": "Converta o tipo de uma cadeia de caracteres `timestamp` no formato ISO 8601 para o número de milissegundos desde a época do Unix (1 January, 1970 UTC) como um número. Um erro é gerado se a cadeia de caracteres não estiver no formato correto. "
+ },
+ "$env": {
+ "args": "arg",
+ "desc": "Retorna o valor de uma variável de ambiente.\n\nEsta é uma função definida pelo Node-RED."
+ },
+ "$eval": {
+ "args": "expr [, context]",
+ "desc": "Analisa e avalia a cadeia de caracteres `expr` que contém um JSON literal ou uma expressão JSONata usando o contexto atual como o contexto para avaliação. "
+ },
+ "$formatInteger": {
+ "args": "number, picture",
+ "desc": "Converte o tipo de `number` em uma cadeia de caracteres e o formata em uma representação inteira conforme especificado pela cadeia de caracteres `picture`. O parâmetro da cadeia de caracteres de imagem define como o número é formatado e tem a mesma sintaxe de `fn: format-integer` do Especificação XPath F&O 3.1. "
+ },
+ "$parseInteger": {
+ "args": "string, picture",
+ "desc": "Examina e troca o conteúdo do parâmetro `string` para um inteiro (como um número JSON) usando o formato especificado pela cadeia de caracteres `picture`. O parâmetro da cadeia de caracteres `picture` tem o mesmo formato que `$ formatInteger`."
+ },
+ "$error": {
+ "args": "[str]",
+ "desc": "Gera um erro com uma mensagem. O (parâmetro) opcional `str` substituirá a mensagem padrão de `$error() function evaluated`"
+ },
+ "$assert": {
+ "args": "arg, str",
+ "desc": "Se `arg` for verdadeiro, a função retorna indefinido. Se `arg` for falso, uma exceção é gerada com `str` como a mensagem da exceção. "
+ },
+ "$single": {
+ "args": "array, function",
+ "desc": "Retorna o único valor no parâmetro `array` que satisfaz o predicado `function` (isto é, O (parâmetro) `function` retorna o booliano `true` quando passado o valor). Gera uma exceção se o número de valores correspondentes não for exatamente um .\n\nA função deve ser fornecida na seguinte assinatura: `function(value [, index [, array]])` onde 'value' é cada entrada da matriz, 'index' é a posição desse valor e toda a matriz é passada como o terceiro argumento"
+ },
+ "$encodeUrlComponent": {
+ "args": "str",
+ "desc": "Codifica um componente Localizador Uniforme de Recursos (URL) substituindo cada instância de certos caracteres por uma, duas, três ou quatro sequências de escape que representam a codificação UTF-8 do caractere.\n\nExemplo: `$encodeUrlComponent(\"?x=test\")` => `\"%3Fx%3Dtest\"`"
+ },
+ "$encodeUrl": {
+ "args": "str",
+ "desc": "Codifica um Localizador Uniforme de Recursos (URL) substituindo cada instância de certos caracteres por uma, duas, três ou quatro sequências de escape que representam a codificação UTF-8 do caractere. \n\nExemplo: `$encodeUrl(\"https://mozilla.org/?x=шеллы\")` => `\"https://mozilla.org/?x=%D1%88%D0%B5%D0%BB%D0%BB%D1%8B\"`"
+ },
+ "$decodeUrlComponent": {
+ "args": "str",
+ "desc": "Decodifica um componente Localizador Uniforme de Recursos (URL) criado anteriormente por encodeUrlComponent. \n\nExemplo: `$decodeUrlComponent(\"%3Fx%3Dtest\")` => `\"?x=test\"`"
+ },
+ "$decodeUrl": {
+ "args": "str",
+ "desc": "Decodifica um Localizador Uniforme de Recursos (URL) criado anteriormente por encodeUrl. \n\nExemplo: `$decodeUrl(\"https://mozilla.org/?x=%D1%88%D0%B5%D0%BB%D0%BB%D1%8B\")` => `\"https://mozilla.org/?x=шеллы\"`"
+ },
+ "$distinct": {
+ "args": "array",
+ "desc": "Retorna uma matriz com valores duplicados removidos da `array` "
+ },
+ "$type": {
+ "args": "value",
+ "desc": "Retorna o tipo de `value` como uma cadeia de caracteres. Se `value` for indefinido, retornará `undefined` "
+ },
+ "$moment": {
+ "args": "[str]",
+ "desc": "Obtém um objeto de dados usando a biblioteca 'Moment'."
+ }
+}
diff --git a/packages/node_modules/@node-red/editor-client/locales/ru/editor.json b/packages/node_modules/@node-red/editor-client/locales/ru/editor.json
old mode 100755
new mode 100644
index d669b3f09..8cfea1bde
--- a/packages/node_modules/@node-red/editor-client/locales/ru/editor.json
+++ b/packages/node_modules/@node-red/editor-client/locales/ru/editor.json
@@ -1133,8 +1133,10 @@
"languages" : {
"de": "Немецкий",
"en-US": "Английский",
+ "fr": "Французский",
"ja": "Японский",
"ko": "Корейский",
+ "pt-BR":"португальский",
"ru": "Русский",
"zh-CN": "Китайский (упрощенный)",
"zh-TW": "Китайский (традиционный)"
diff --git a/packages/node_modules/@node-red/editor-client/locales/ru/infotips.json b/packages/node_modules/@node-red/editor-client/locales/ru/infotips.json
old mode 100755
new mode 100644
diff --git a/packages/node_modules/@node-red/editor-client/locales/ru/jsonata.json b/packages/node_modules/@node-red/editor-client/locales/ru/jsonata.json
old mode 100755
new mode 100644
diff --git a/packages/node_modules/@node-red/editor-client/locales/zh-CN/editor.json b/packages/node_modules/@node-red/editor-client/locales/zh-CN/editor.json
index eca5878ae..e55240cc5 100644
--- a/packages/node_modules/@node-red/editor-client/locales/zh-CN/editor.json
+++ b/packages/node_modules/@node-red/editor-client/locales/zh-CN/editor.json
@@ -1,1095 +1,1221 @@
{
- "common": {
- "label": {
- "name": "姓名",
- "ok": "确认",
- "done": "完成",
- "cancel": "取消",
- "delete": "删除",
- "close": "关闭",
- "load": "读取",
- "save": "保存",
- "import": "导入",
- "export": "导出",
- "back": "后退",
- "next": "下一个",
- "clone": "克隆项目",
- "cont": "继续",
- "style": "风格",
- "line": "大纲",
- "fill": "填充",
- "label": "标签",
- "color": "颜色",
- "position": "位置",
- "enable": "启用",
- "disable": "禁用",
- "upload": "上传"
- },
- "type": {
- "string": "字符串",
- "number": "数字",
- "boolean": "布尔值",
- "array": "数组",
- "buffer": "buffer",
- "object": "对象",
- "jsonString": "JSON字符串",
- "undefined": "未定义",
- "null": "空"
- }
+ "common": {
+ "label": {
+ "name": "名称",
+ "ok": "确认",
+ "done": "完成",
+ "cancel": "取消",
+ "delete": "删除",
+ "close": "关闭",
+ "load": "读取",
+ "save": "保存",
+ "import": "导入",
+ "export": "导出",
+ "back": "后退",
+ "next": "下一个",
+ "clone": "克隆项目",
+ "cont": "继续",
+ "style": "样式",
+ "line": "大纲",
+ "fill": "填充",
+ "label": "标签",
+ "color": "颜色",
+ "position": "位置",
+ "enable": "启用",
+ "disable": "禁用",
+ "upload": "上传"
},
- "event": {
- "loadPalette": "加载控制板",
- "loadNodeCatalogs": "加载节点目录",
- "loadNodes": "加载 __count__ 个节点",
- "loadFlows": "加载流程",
- "importFlows": "往工作区中加载流程"
+ "type": {
+ "string": "字符串",
+ "number": "数字",
+ "boolean": "布尔值",
+ "array": "数组",
+ "buffer": "buffer",
+ "object": "对象",
+ "jsonString": "JSON字符串",
+ "undefined": "未定义",
+ "null": "空"
+ }
+ },
+ "event": {
+ "loadPlugins": "加载插件",
+ "loadPalette": "加载控制板",
+ "loadNodeCatalogs": "加载节点目录",
+ "loadNodes": "加载 __count__ 个节点",
+ "loadFlows": "加载流程",
+ "importFlows": "往工作区中加载流程",
+ "importError": "
Some nodes have been updated to generate a unique name when
+ new instances are added to the workspace. This applies to
+ Debug, Function and Link nodes.
+
A new action has also been added to generate default names for the selected
+ nodes:
+
+
Generate Node Names
+
Actions can be accessed from the Action List in the main menu.
Some nodes have been updated to generate a unique name when
- new instances are added to the workspace. This applies to
- Debug, Function and Link nodes.
-
A new action has also been added to generate default names for the selected
- nodes:
-
-
Generate Node Names
-
Actions can be accessed from the Action List in the main menu.
The Debug node can be configured to count messages it receives
-
The Link Call node can use a message property to dynamically target the link it should call
-
The HTTP Request node can be preconfigured with HTTP headers
-
`,
- "ja": `
-
Debugノードは、受信したメッセージの数をカウントするよう設定できるようになりました。
-
Link Callノードは、メッセージのプロパティによって、呼び出し対象のlinkを動的に指定できるようになりました。
-
HTTP Requestノードは、HTTPヘッダを事前設定できるようになりました。
-
`
+ "en-US": `
The core nodes have received lots of minor fixes, documentation updates and
+ small enhancements. Check the full changelog in the Help sidebar for a full list.
`
}
}
]
diff --git a/packages/node_modules/@node-red/editor-client/src/types/node-red/func.d.ts b/packages/node_modules/@node-red/editor-client/src/types/node-red/func.d.ts
index ae411f33c..fd2adcbd8 100644
--- a/packages/node_modules/@node-red/editor-client/src/types/node-red/func.d.ts
+++ b/packages/node_modules/@node-red/editor-client/src/types/node-red/func.d.ts
@@ -14,6 +14,9 @@ declare var msg: NodeMessage;
/** @type {string} the id of the incoming `msg` (alias of msg._msgid) */
declare const __msgid__:string;
+declare const util:typeof import('util')
+declare const promisify:typeof import('util').promisify
+
/**
* @typedef NodeStatus
* @type {object}
diff --git a/packages/node_modules/@node-red/editor-client/src/types/node/assert.d.ts b/packages/node_modules/@node-red/editor-client/src/types/node/assert.d.ts
index 6fcb3ce62..4cfbb7321 100644
--- a/packages/node_modules/@node-red/editor-client/src/types/node/assert.d.ts
+++ b/packages/node_modules/@node-red/editor-client/src/types/node/assert.d.ts
@@ -1,24 +1,36 @@
/* NOTE: Do not edit directly! This file is generated using `npm run update-types` in https://github.com/Steve-Mcl/monaco-editor-esm-i18n */
+/**
+ * The `assert` module provides a set of assertion functions for verifying
+ * invariants.
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/assert.js)
+ */
declare module 'assert' {
- /** An alias of `assert.ok()`. */
- function assert(value: any, message?: string | Error): asserts value;
+ /**
+ * An alias of {@link ok}.
+ * @since v0.5.9
+ * @param value The input that is checked for being truthy.
+ */
+ function assert(value: unknown, message?: string | Error): asserts value;
namespace assert {
+ /**
+ * Indicates the failure of an assertion. All errors thrown by the `assert` module
+ * will be instances of the `AssertionError` class.
+ */
class AssertionError extends Error {
- actual: any;
- expected: any;
+ actual: unknown;
+ expected: unknown;
operator: string;
generatedMessage: boolean;
code: 'ERR_ASSERTION';
-
constructor(options?: {
/** If provided, the error message is set to this value. */
message?: string | undefined;
/** The `actual` property on the error instance. */
- actual?: any;
+ actual?: unknown | undefined;
/** The `expected` property on the error instance. */
- expected?: any;
+ expected?: unknown | undefined;
/** The `operator` property on the error instance. */
operator?: string | undefined;
/** If provided, the generated stack trace omits frames before this function. */
@@ -26,13 +38,146 @@ declare module 'assert' {
stackStartFn?: Function | undefined;
});
}
-
+ /**
+ * This feature is currently experimental and behavior might still change.
+ * @since v14.2.0, v12.19.0
+ * @experimental
+ */
class CallTracker {
+ /**
+ * The wrapper function is expected to be called exactly `exact` times. If the
+ * function has not been called exactly `exact` times when `tracker.verify()` is called, then `tracker.verify()` will throw an
+ * error.
+ *
+ * ```js
+ * import assert from 'assert';
+ *
+ * // Creates call tracker.
+ * const tracker = new assert.CallTracker();
+ *
+ * function func() {}
+ *
+ * // Returns a function that wraps func() that must be called exact times
+ * // before tracker.verify().
+ * const callsfunc = tracker.calls(func);
+ * ```
+ * @since v14.2.0, v12.19.0
+ * @param [fn='A no-op function']
+ * @param [exact=1]
+ * @return that wraps `fn`.
+ */
calls(exact?: number): () => void;
calls any>(fn?: Func, exact?: number): Func;
+ /**
+ * Example:
+ *
+ * ```js
+ * import assert from 'node:assert';
+ *
+ * const tracker = new assert.CallTracker();
+ *
+ * function func() {}
+ * const callsfunc = tracker.calls(func);
+ * callsfunc(1, 2, 3);
+ *
+ * assert.deepStrictEqual(tracker.getCalls(callsfunc),
+ * [{ thisArg: this, arguments: [1, 2, 3 ] }]);
+ * ```
+ *
+ * @since v18.8.0, v16.18.0
+ * @params fn
+ * @returns An Array with the calls to a tracked function.
+ */
+ getCalls(fn: Function): CallTrackerCall[];
+ /**
+ * The arrays contains information about the expected and actual number of calls of
+ * the functions that have not been called the expected number of times.
+ *
+ * ```js
+ * import assert from 'assert';
+ *
+ * // Creates call tracker.
+ * const tracker = new assert.CallTracker();
+ *
+ * function func() {}
+ *
+ * function foo() {}
+ *
+ * // Returns a function that wraps func() that must be called exact times
+ * // before tracker.verify().
+ * const callsfunc = tracker.calls(func, 2);
+ *
+ * // Returns an array containing information on callsfunc()
+ * tracker.report();
+ * // [
+ * // {
+ * // message: 'Expected the func function to be executed 2 time(s) but was
+ * // executed 0 time(s).',
+ * // actual: 0,
+ * // expected: 2,
+ * // operator: 'func',
+ * // stack: stack trace
+ * // }
+ * // ]
+ * ```
+ * @since v14.2.0, v12.19.0
+ * @return of objects containing information about the wrapper functions returned by `calls`.
+ */
report(): CallTrackerReportInformation[];
+ /**
+ * Reset calls of the call tracker.
+ * If a tracked function is passed as an argument, the calls will be reset for it.
+ * If no arguments are passed, all tracked functions will be reset.
+ *
+ * ```js
+ * import assert from 'node:assert';
+ *
+ * const tracker = new assert.CallTracker();
+ *
+ * function func() {}
+ * const callsfunc = tracker.calls(func);
+ *
+ * callsfunc();
+ * // Tracker was called once
+ * tracker.getCalls(callsfunc).length === 1;
+ *
+ * tracker.reset(callsfunc);
+ * tracker.getCalls(callsfunc).length === 0;
+ * ```
+ *
+ * @since v18.8.0, v16.18.0
+ * @param fn a tracked function to reset.
+ */
+ reset(fn?: Function): void;
+ /**
+ * Iterates through the list of functions passed to `tracker.calls()` and will throw an error for functions that
+ * have not been called the expected number of times.
+ *
+ * ```js
+ * import assert from 'assert';
+ *
+ * // Creates call tracker.
+ * const tracker = new assert.CallTracker();
+ *
+ * function func() {}
+ *
+ * // Returns a function that wraps func() that must be called exact times
+ * // before tracker.verify().
+ * const callsfunc = tracker.calls(func, 2);
+ *
+ * callsfunc();
+ *
+ * // Will throw an error since callsfunc() was only called once.
+ * tracker.verify();
+ * ```
+ * @since v14.2.0, v12.19.0
+ */
verify(): void;
}
+ interface CallTrackerCall {
+ thisArg: object;
+ arguments: unknown[];
+ }
interface CallTrackerReportInformation {
message: string;
/** The actual number of times the function was called. */
@@ -44,74 +189,764 @@ declare module 'assert' {
/** A stack trace of the function. */
stack: object;
}
-
- type AssertPredicate = RegExp | (new () => object) | ((thrown: any) => boolean) | object | Error;
-
+ type AssertPredicate = RegExp | (new () => object) | ((thrown: unknown) => boolean) | object | Error;
+ /**
+ * Throws an `AssertionError` with the provided error message or a default
+ * error message. If the `message` parameter is an instance of an `Error` then
+ * it will be thrown instead of the `AssertionError`.
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.fail();
+ * // AssertionError [ERR_ASSERTION]: Failed
+ *
+ * assert.fail('boom');
+ * // AssertionError [ERR_ASSERTION]: boom
+ *
+ * assert.fail(new TypeError('need array'));
+ * // TypeError: need array
+ * ```
+ *
+ * Using `assert.fail()` with more than two arguments is possible but deprecated.
+ * See below for further details.
+ * @since v0.1.21
+ * @param [message='Failed']
+ */
function fail(message?: string | Error): never;
/** @deprecated since v10.0.0 - use fail([message]) or other assert functions instead. */
function fail(
- actual: any,
- expected: any,
+ actual: unknown,
+ expected: unknown,
message?: string | Error,
operator?: string,
// tslint:disable-next-line:ban-types
- stackStartFn?: Function,
+ stackStartFn?: Function
): never;
- function ok(value: any, message?: string | Error): asserts value;
- /** @deprecated since v9.9.0 - use strictEqual() instead. */
- function equal(actual: any, expected: any, message?: string | Error): void;
- /** @deprecated since v9.9.0 - use notStrictEqual() instead. */
- function notEqual(actual: any, expected: any, message?: string | Error): void;
- /** @deprecated since v9.9.0 - use deepStrictEqual() instead. */
- function deepEqual(actual: any, expected: any, message?: string | Error): void;
- /** @deprecated since v9.9.0 - use notDeepStrictEqual() instead. */
- function notDeepEqual(actual: any, expected: any, message?: string | Error): void;
- function strictEqual(actual: any, expected: T, message?: string | Error): asserts actual is T;
- function notStrictEqual(actual: any, expected: any, message?: string | Error): void;
- function deepStrictEqual(actual: any, expected: T, message?: string | Error): asserts actual is T;
- function notDeepStrictEqual(actual: any, expected: any, message?: string | Error): void;
-
- function throws(block: () => any, message?: string | Error): void;
- function throws(block: () => any, error: AssertPredicate, message?: string | Error): void;
- function doesNotThrow(block: () => any, message?: string | Error): void;
- function doesNotThrow(block: () => any, error: AssertPredicate, message?: string | Error): void;
-
- function ifError(value: any): asserts value is null | undefined;
-
- function rejects(block: (() => Promise) | Promise, message?: string | Error): Promise;
- function rejects(
- block: (() => Promise) | Promise,
- error: AssertPredicate,
- message?: string | Error,
- ): Promise;
- function doesNotReject(block: (() => Promise) | Promise, message?: string | Error): Promise;
- function doesNotReject(
- block: (() => Promise) | Promise,
- error: AssertPredicate,
- message?: string | Error,
- ): Promise;
-
+ /**
+ * Tests if `value` is truthy. It is equivalent to`assert.equal(!!value, true, message)`.
+ *
+ * If `value` is not truthy, an `AssertionError` is thrown with a `message`property set equal to the value of the `message` parameter. If the `message`parameter is `undefined`, a default
+ * error message is assigned. If the `message`parameter is an instance of an `Error` then it will be thrown instead of the`AssertionError`.
+ * If no arguments are passed in at all `message` will be set to the string:`` 'No value argument passed to `assert.ok()`' ``.
+ *
+ * Be aware that in the `repl` the error message will be different to the one
+ * thrown in a file! See below for further details.
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.ok(true);
+ * // OK
+ * assert.ok(1);
+ * // OK
+ *
+ * assert.ok();
+ * // AssertionError: No value argument passed to `assert.ok()`
+ *
+ * assert.ok(false, 'it\'s false');
+ * // AssertionError: it's false
+ *
+ * // In the repl:
+ * assert.ok(typeof 123 === 'string');
+ * // AssertionError: false == true
+ *
+ * // In a file (e.g. test.js):
+ * assert.ok(typeof 123 === 'string');
+ * // AssertionError: The expression evaluated to a falsy value:
+ * //
+ * // assert.ok(typeof 123 === 'string')
+ *
+ * assert.ok(false);
+ * // AssertionError: The expression evaluated to a falsy value:
+ * //
+ * // assert.ok(false)
+ *
+ * assert.ok(0);
+ * // AssertionError: The expression evaluated to a falsy value:
+ * //
+ * // assert.ok(0)
+ * ```
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * // Using `assert()` works the same:
+ * assert(0);
+ * // AssertionError: The expression evaluated to a falsy value:
+ * //
+ * // assert(0)
+ * ```
+ * @since v0.1.21
+ */
+ function ok(value: unknown, message?: string | Error): asserts value;
+ /**
+ * **Strict assertion mode**
+ *
+ * An alias of {@link strictEqual}.
+ *
+ * **Legacy assertion mode**
+ *
+ * > Stability: 3 - Legacy: Use {@link strictEqual} instead.
+ *
+ * Tests shallow, coercive equality between the `actual` and `expected` parameters
+ * using the [Abstract Equality Comparison](https://tc39.github.io/ecma262/#sec-abstract-equality-comparison) ( `==` ). `NaN` is special handled
+ * and treated as being identical in case both sides are `NaN`.
+ *
+ * ```js
+ * import assert from 'assert';
+ *
+ * assert.equal(1, 1);
+ * // OK, 1 == 1
+ * assert.equal(1, '1');
+ * // OK, 1 == '1'
+ * assert.equal(NaN, NaN);
+ * // OK
+ *
+ * assert.equal(1, 2);
+ * // AssertionError: 1 == 2
+ * assert.equal({ a: { b: 1 } }, { a: { b: 1 } });
+ * // AssertionError: { a: { b: 1 } } == { a: { b: 1 } }
+ * ```
+ *
+ * If the values are not equal, an `AssertionError` is thrown with a `message`property set equal to the value of the `message` parameter. If the `message`parameter is undefined, a default
+ * error message is assigned. If the `message`parameter is an instance of an `Error` then it will be thrown instead of the`AssertionError`.
+ * @since v0.1.21
+ */
+ function equal(actual: unknown, expected: unknown, message?: string | Error): void;
+ /**
+ * **Strict assertion mode**
+ *
+ * An alias of {@link notStrictEqual}.
+ *
+ * **Legacy assertion mode**
+ *
+ * > Stability: 3 - Legacy: Use {@link notStrictEqual} instead.
+ *
+ * Tests shallow, coercive inequality with the [Abstract Equality Comparison](https://tc39.github.io/ecma262/#sec-abstract-equality-comparison)(`!=` ). `NaN` is special handled and treated as
+ * being identical in case both
+ * sides are `NaN`.
+ *
+ * ```js
+ * import assert from 'assert';
+ *
+ * assert.notEqual(1, 2);
+ * // OK
+ *
+ * assert.notEqual(1, 1);
+ * // AssertionError: 1 != 1
+ *
+ * assert.notEqual(1, '1');
+ * // AssertionError: 1 != '1'
+ * ```
+ *
+ * If the values are equal, an `AssertionError` is thrown with a `message`property set equal to the value of the `message` parameter. If the `message`parameter is undefined, a default error
+ * message is assigned. If the `message`parameter is an instance of an `Error` then it will be thrown instead of the`AssertionError`.
+ * @since v0.1.21
+ */
+ function notEqual(actual: unknown, expected: unknown, message?: string | Error): void;
+ /**
+ * **Strict assertion mode**
+ *
+ * An alias of {@link deepStrictEqual}.
+ *
+ * **Legacy assertion mode**
+ *
+ * > Stability: 3 - Legacy: Use {@link deepStrictEqual} instead.
+ *
+ * Tests for deep equality between the `actual` and `expected` parameters. Consider
+ * using {@link deepStrictEqual} instead. {@link deepEqual} can have
+ * surprising results.
+ *
+ * _Deep equality_ means that the enumerable "own" properties of child objects
+ * are also recursively evaluated by the following rules.
+ * @since v0.1.21
+ */
+ function deepEqual(actual: unknown, expected: unknown, message?: string | Error): void;
+ /**
+ * **Strict assertion mode**
+ *
+ * An alias of {@link notDeepStrictEqual}.
+ *
+ * **Legacy assertion mode**
+ *
+ * > Stability: 3 - Legacy: Use {@link notDeepStrictEqual} instead.
+ *
+ * Tests for any deep inequality. Opposite of {@link deepEqual}.
+ *
+ * ```js
+ * import assert from 'assert';
+ *
+ * const obj1 = {
+ * a: {
+ * b: 1
+ * }
+ * };
+ * const obj2 = {
+ * a: {
+ * b: 2
+ * }
+ * };
+ * const obj3 = {
+ * a: {
+ * b: 1
+ * }
+ * };
+ * const obj4 = Object.create(obj1);
+ *
+ * assert.notDeepEqual(obj1, obj1);
+ * // AssertionError: { a: { b: 1 } } notDeepEqual { a: { b: 1 } }
+ *
+ * assert.notDeepEqual(obj1, obj2);
+ * // OK
+ *
+ * assert.notDeepEqual(obj1, obj3);
+ * // AssertionError: { a: { b: 1 } } notDeepEqual { a: { b: 1 } }
+ *
+ * assert.notDeepEqual(obj1, obj4);
+ * // OK
+ * ```
+ *
+ * If the values are deeply equal, an `AssertionError` is thrown with a`message` property set equal to the value of the `message` parameter. If the`message` parameter is undefined, a default
+ * error message is assigned. If the`message` parameter is an instance of an `Error` then it will be thrown
+ * instead of the `AssertionError`.
+ * @since v0.1.21
+ */
+ function notDeepEqual(actual: unknown, expected: unknown, message?: string | Error): void;
+ /**
+ * Tests strict equality between the `actual` and `expected` parameters as
+ * determined by the [SameValue Comparison](https://tc39.github.io/ecma262/#sec-samevalue).
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.strictEqual(1, 2);
+ * // AssertionError [ERR_ASSERTION]: Expected inputs to be strictly equal:
+ * //
+ * // 1 !== 2
+ *
+ * assert.strictEqual(1, 1);
+ * // OK
+ *
+ * assert.strictEqual('Hello foobar', 'Hello World!');
+ * // AssertionError [ERR_ASSERTION]: Expected inputs to be strictly equal:
+ * // + actual - expected
+ * //
+ * // + 'Hello foobar'
+ * // - 'Hello World!'
+ * // ^
+ *
+ * const apples = 1;
+ * const oranges = 2;
+ * assert.strictEqual(apples, oranges, `apples ${apples} !== oranges ${oranges}`);
+ * // AssertionError [ERR_ASSERTION]: apples 1 !== oranges 2
+ *
+ * assert.strictEqual(1, '1', new TypeError('Inputs are not identical'));
+ * // TypeError: Inputs are not identical
+ * ```
+ *
+ * If the values are not strictly equal, an `AssertionError` is thrown with a`message` property set equal to the value of the `message` parameter. If the`message` parameter is undefined, a
+ * default error message is assigned. If the`message` parameter is an instance of an `Error` then it will be thrown
+ * instead of the `AssertionError`.
+ * @since v0.1.21
+ */
+ function strictEqual(actual: unknown, expected: T, message?: string | Error): asserts actual is T;
+ /**
+ * Tests strict inequality between the `actual` and `expected` parameters as
+ * determined by the [SameValue Comparison](https://tc39.github.io/ecma262/#sec-samevalue).
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.notStrictEqual(1, 2);
+ * // OK
+ *
+ * assert.notStrictEqual(1, 1);
+ * // AssertionError [ERR_ASSERTION]: Expected "actual" to be strictly unequal to:
+ * //
+ * // 1
+ *
+ * assert.notStrictEqual(1, '1');
+ * // OK
+ * ```
+ *
+ * If the values are strictly equal, an `AssertionError` is thrown with a`message` property set equal to the value of the `message` parameter. If the`message` parameter is undefined, a
+ * default error message is assigned. If the`message` parameter is an instance of an `Error` then it will be thrown
+ * instead of the `AssertionError`.
+ * @since v0.1.21
+ */
+ function notStrictEqual(actual: unknown, expected: unknown, message?: string | Error): void;
+ /**
+ * Tests for deep equality between the `actual` and `expected` parameters.
+ * "Deep" equality means that the enumerable "own" properties of child objects
+ * are recursively evaluated also by the following rules.
+ * @since v1.2.0
+ */
+ function deepStrictEqual(actual: unknown, expected: T, message?: string | Error): asserts actual is T;
+ /**
+ * Tests for deep strict inequality. Opposite of {@link deepStrictEqual}.
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.notDeepStrictEqual({ a: 1 }, { a: '1' });
+ * // OK
+ * ```
+ *
+ * If the values are deeply and strictly equal, an `AssertionError` is thrown
+ * with a `message` property set equal to the value of the `message` parameter. If
+ * the `message` parameter is undefined, a default error message is assigned. If
+ * the `message` parameter is an instance of an `Error` then it will be thrown
+ * instead of the `AssertionError`.
+ * @since v1.2.0
+ */
+ function notDeepStrictEqual(actual: unknown, expected: unknown, message?: string | Error): void;
+ /**
+ * Expects the function `fn` to throw an error.
+ *
+ * If specified, `error` can be a [`Class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes),
+ * [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions), a validation function,
+ * a validation object where each property will be tested for strict deep equality,
+ * or an instance of error where each property will be tested for strict deep
+ * equality including the non-enumerable `message` and `name` properties. When
+ * using an object, it is also possible to use a regular expression, when
+ * validating against a string property. See below for examples.
+ *
+ * If specified, `message` will be appended to the message provided by the`AssertionError` if the `fn` call fails to throw or in case the error validation
+ * fails.
+ *
+ * Custom validation object/error instance:
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * const err = new TypeError('Wrong value');
+ * err.code = 404;
+ * err.foo = 'bar';
+ * err.info = {
+ * nested: true,
+ * baz: 'text'
+ * };
+ * err.reg = /abc/i;
+ *
+ * assert.throws(
+ * () => {
+ * throw err;
+ * },
+ * {
+ * name: 'TypeError',
+ * message: 'Wrong value',
+ * info: {
+ * nested: true,
+ * baz: 'text'
+ * }
+ * // Only properties on the validation object will be tested for.
+ * // Using nested objects requires all properties to be present. Otherwise
+ * // the validation is going to fail.
+ * }
+ * );
+ *
+ * // Using regular expressions to validate error properties:
+ * throws(
+ * () => {
+ * throw err;
+ * },
+ * {
+ * // The `name` and `message` properties are strings and using regular
+ * // expressions on those will match against the string. If they fail, an
+ * // error is thrown.
+ * name: /^TypeError$/,
+ * message: /Wrong/,
+ * foo: 'bar',
+ * info: {
+ * nested: true,
+ * // It is not possible to use regular expressions for nested properties!
+ * baz: 'text'
+ * },
+ * // The `reg` property contains a regular expression and only if the
+ * // validation object contains an identical regular expression, it is going
+ * // to pass.
+ * reg: /abc/i
+ * }
+ * );
+ *
+ * // Fails due to the different `message` and `name` properties:
+ * throws(
+ * () => {
+ * const otherErr = new Error('Not found');
+ * // Copy all enumerable properties from `err` to `otherErr`.
+ * for (const [key, value] of Object.entries(err)) {
+ * otherErr[key] = value;
+ * }
+ * throw otherErr;
+ * },
+ * // The error's `message` and `name` properties will also be checked when using
+ * // an error as validation object.
+ * err
+ * );
+ * ```
+ *
+ * Validate instanceof using constructor:
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.throws(
+ * () => {
+ * throw new Error('Wrong value');
+ * },
+ * Error
+ * );
+ * ```
+ *
+ * Validate error message using [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions):
+ *
+ * Using a regular expression runs `.toString` on the error object, and will
+ * therefore also include the error name.
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.throws(
+ * () => {
+ * throw new Error('Wrong value');
+ * },
+ * /^Error: Wrong value$/
+ * );
+ * ```
+ *
+ * Custom error validation:
+ *
+ * The function must return `true` to indicate all internal validations passed.
+ * It will otherwise fail with an `AssertionError`.
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.throws(
+ * () => {
+ * throw new Error('Wrong value');
+ * },
+ * (err) => {
+ * assert(err instanceof Error);
+ * assert(/value/.test(err));
+ * // Avoid returning anything from validation functions besides `true`.
+ * // Otherwise, it's not clear what part of the validation failed. Instead,
+ * // throw an error about the specific validation that failed (as done in this
+ * // example) and add as much helpful debugging information to that error as
+ * // possible.
+ * return true;
+ * },
+ * 'unexpected error'
+ * );
+ * ```
+ *
+ * `error` cannot be a string. If a string is provided as the second
+ * argument, then `error` is assumed to be omitted and the string will be used for`message` instead. This can lead to easy-to-miss mistakes. Using the same
+ * message as the thrown error message is going to result in an`ERR_AMBIGUOUS_ARGUMENT` error. Please read the example below carefully if using
+ * a string as the second argument gets considered:
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * function throwingFirst() {
+ * throw new Error('First');
+ * }
+ *
+ * function throwingSecond() {
+ * throw new Error('Second');
+ * }
+ *
+ * function notThrowing() {}
+ *
+ * // The second argument is a string and the input function threw an Error.
+ * // The first case will not throw as it does not match for the error message
+ * // thrown by the input function!
+ * assert.throws(throwingFirst, 'Second');
+ * // In the next example the message has no benefit over the message from the
+ * // error and since it is not clear if the user intended to actually match
+ * // against the error message, Node.js throws an `ERR_AMBIGUOUS_ARGUMENT` error.
+ * assert.throws(throwingSecond, 'Second');
+ * // TypeError [ERR_AMBIGUOUS_ARGUMENT]
+ *
+ * // The string is only used (as message) in case the function does not throw:
+ * assert.throws(notThrowing, 'Second');
+ * // AssertionError [ERR_ASSERTION]: Missing expected exception: Second
+ *
+ * // If it was intended to match for the error message do this instead:
+ * // It does not throw because the error messages match.
+ * assert.throws(throwingSecond, /Second$/);
+ *
+ * // If the error message does not match, an AssertionError is thrown.
+ * assert.throws(throwingFirst, /Second$/);
+ * // AssertionError [ERR_ASSERTION]
+ * ```
+ *
+ * Due to the confusing error-prone notation, avoid a string as the second
+ * argument.
+ * @since v0.1.21
+ */
+ function throws(block: () => unknown, message?: string | Error): void;
+ function throws(block: () => unknown, error: AssertPredicate, message?: string | Error): void;
+ /**
+ * Asserts that the function `fn` does not throw an error.
+ *
+ * Using `assert.doesNotThrow()` is actually not useful because there
+ * is no benefit in catching an error and then rethrowing it. Instead, consider
+ * adding a comment next to the specific code path that should not throw and keep
+ * error messages as expressive as possible.
+ *
+ * When `assert.doesNotThrow()` is called, it will immediately call the `fn`function.
+ *
+ * If an error is thrown and it is the same type as that specified by the `error`parameter, then an `AssertionError` is thrown. If the error is of a
+ * different type, or if the `error` parameter is undefined, the error is
+ * propagated back to the caller.
+ *
+ * If specified, `error` can be a [`Class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes),
+ * [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions) or a validation
+ * function. See {@link throws} for more details.
+ *
+ * The following, for instance, will throw the `TypeError` because there is no
+ * matching error type in the assertion:
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.doesNotThrow(
+ * () => {
+ * throw new TypeError('Wrong value');
+ * },
+ * SyntaxError
+ * );
+ * ```
+ *
+ * However, the following will result in an `AssertionError` with the message
+ * 'Got unwanted exception...':
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.doesNotThrow(
+ * () => {
+ * throw new TypeError('Wrong value');
+ * },
+ * TypeError
+ * );
+ * ```
+ *
+ * If an `AssertionError` is thrown and a value is provided for the `message`parameter, the value of `message` will be appended to the `AssertionError` message:
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.doesNotThrow(
+ * () => {
+ * throw new TypeError('Wrong value');
+ * },
+ * /Wrong value/,
+ * 'Whoops'
+ * );
+ * // Throws: AssertionError: Got unwanted exception: Whoops
+ * ```
+ * @since v0.1.21
+ */
+ function doesNotThrow(block: () => unknown, message?: string | Error): void;
+ function doesNotThrow(block: () => unknown, error: AssertPredicate, message?: string | Error): void;
+ /**
+ * Throws `value` if `value` is not `undefined` or `null`. This is useful when
+ * testing the `error` argument in callbacks. The stack trace contains all frames
+ * from the error passed to `ifError()` including the potential new frames for`ifError()` itself.
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.ifError(null);
+ * // OK
+ * assert.ifError(0);
+ * // AssertionError [ERR_ASSERTION]: ifError got unwanted exception: 0
+ * assert.ifError('error');
+ * // AssertionError [ERR_ASSERTION]: ifError got unwanted exception: 'error'
+ * assert.ifError(new Error());
+ * // AssertionError [ERR_ASSERTION]: ifError got unwanted exception: Error
+ *
+ * // Create some random error frames.
+ * let err;
+ * (function errorFrame() {
+ * err = new Error('test error');
+ * })();
+ *
+ * (function ifErrorFrame() {
+ * assert.ifError(err);
+ * })();
+ * // AssertionError [ERR_ASSERTION]: ifError got unwanted exception: test error
+ * // at ifErrorFrame
+ * // at errorFrame
+ * ```
+ * @since v0.1.97
+ */
+ function ifError(value: unknown): asserts value is null | undefined;
+ /**
+ * Awaits the `asyncFn` promise or, if `asyncFn` is a function, immediately
+ * calls the function and awaits the returned promise to complete. It will then
+ * check that the promise is rejected.
+ *
+ * If `asyncFn` is a function and it throws an error synchronously,`assert.rejects()` will return a rejected `Promise` with that error. If the
+ * function does not return a promise, `assert.rejects()` will return a rejected`Promise` with an `ERR_INVALID_RETURN_VALUE` error. In both cases the error
+ * handler is skipped.
+ *
+ * Besides the async nature to await the completion behaves identically to {@link throws}.
+ *
+ * If specified, `error` can be a [`Class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes),
+ * [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions), a validation function,
+ * an object where each property will be tested for, or an instance of error where
+ * each property will be tested for including the non-enumerable `message` and`name` properties.
+ *
+ * If specified, `message` will be the message provided by the `AssertionError` if the `asyncFn` fails to reject.
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * await assert.rejects(
+ * async () => {
+ * throw new TypeError('Wrong value');
+ * },
+ * {
+ * name: 'TypeError',
+ * message: 'Wrong value'
+ * }
+ * );
+ * ```
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * await assert.rejects(
+ * async () => {
+ * throw new TypeError('Wrong value');
+ * },
+ * (err) => {
+ * assert.strictEqual(err.name, 'TypeError');
+ * assert.strictEqual(err.message, 'Wrong value');
+ * return true;
+ * }
+ * );
+ * ```
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.rejects(
+ * Promise.reject(new Error('Wrong value')),
+ * Error
+ * ).then(() => {
+ * // ...
+ * });
+ * ```
+ *
+ * `error` cannot be a string. If a string is provided as the second
+ * argument, then `error` is assumed to be omitted and the string will be used for`message` instead. This can lead to easy-to-miss mistakes. Please read the
+ * example in {@link throws} carefully if using a string as the second
+ * argument gets considered.
+ * @since v10.0.0
+ */
+ function rejects(block: (() => Promise) | Promise, message?: string | Error): Promise;
+ function rejects(block: (() => Promise) | Promise, error: AssertPredicate, message?: string | Error): Promise;
+ /**
+ * Awaits the `asyncFn` promise or, if `asyncFn` is a function, immediately
+ * calls the function and awaits the returned promise to complete. It will then
+ * check that the promise is not rejected.
+ *
+ * If `asyncFn` is a function and it throws an error synchronously,`assert.doesNotReject()` will return a rejected `Promise` with that error. If
+ * the function does not return a promise, `assert.doesNotReject()` will return a
+ * rejected `Promise` with an `ERR_INVALID_RETURN_VALUE` error. In both cases
+ * the error handler is skipped.
+ *
+ * Using `assert.doesNotReject()` is actually not useful because there is little
+ * benefit in catching a rejection and then rejecting it again. Instead, consider
+ * adding a comment next to the specific code path that should not reject and keep
+ * error messages as expressive as possible.
+ *
+ * If specified, `error` can be a [`Class`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes),
+ * [`RegExp`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions) or a validation
+ * function. See {@link throws} for more details.
+ *
+ * Besides the async nature to await the completion behaves identically to {@link doesNotThrow}.
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * await assert.doesNotReject(
+ * async () => {
+ * throw new TypeError('Wrong value');
+ * },
+ * SyntaxError
+ * );
+ * ```
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.doesNotReject(Promise.reject(new TypeError('Wrong value')))
+ * .then(() => {
+ * // ...
+ * });
+ * ```
+ * @since v10.0.0
+ */
+ function doesNotReject(block: (() => Promise) | Promise, message?: string | Error): Promise;
+ function doesNotReject(block: (() => Promise) | Promise, error: AssertPredicate, message?: string | Error): Promise;
+ /**
+ * Expects the `string` input to match the regular expression.
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.match('I will fail', /pass/);
+ * // AssertionError [ERR_ASSERTION]: The input did not match the regular ...
+ *
+ * assert.match(123, /pass/);
+ * // AssertionError [ERR_ASSERTION]: The "string" argument must be of type string.
+ *
+ * assert.match('I will pass', /pass/);
+ * // OK
+ * ```
+ *
+ * If the values do not match, or if the `string` argument is of another type than`string`, an `AssertionError` is thrown with a `message` property set equal
+ * to the value of the `message` parameter. If the `message` parameter is
+ * undefined, a default error message is assigned. If the `message` parameter is an
+ * instance of an `Error` then it will be thrown instead of the `AssertionError`.
+ * @since v13.6.0, v12.16.0
+ */
function match(value: string, regExp: RegExp, message?: string | Error): void;
+ /**
+ * Expects the `string` input not to match the regular expression.
+ *
+ * ```js
+ * import assert from 'assert/strict';
+ *
+ * assert.doesNotMatch('I will fail', /fail/);
+ * // AssertionError [ERR_ASSERTION]: The input was expected to not match the ...
+ *
+ * assert.doesNotMatch(123, /pass/);
+ * // AssertionError [ERR_ASSERTION]: The "string" argument must be of type string.
+ *
+ * assert.doesNotMatch('I will pass', /different/);
+ * // OK
+ * ```
+ *
+ * If the values do match, or if the `string` argument is of another type than`string`, an `AssertionError` is thrown with a `message` property set equal
+ * to the value of the `message` parameter. If the `message` parameter is
+ * undefined, a default error message is assigned. If the `message` parameter is an
+ * instance of an `Error` then it will be thrown instead of the `AssertionError`.
+ * @since v13.6.0, v12.16.0
+ */
function doesNotMatch(value: string, regExp: RegExp, message?: string | Error): void;
-
- const strict: Omit<
- typeof assert,
- | 'equal'
- | 'notEqual'
- | 'deepEqual'
- | 'notDeepEqual'
- | 'ok'
- | 'strictEqual'
- | 'deepStrictEqual'
- | 'ifError'
- | 'strict'
- > & {
- (value: any, message?: string | Error): asserts value;
+ const strict: Omit & {
+ (value: unknown, message?: string | Error): asserts value;
equal: typeof strictEqual;
notEqual: typeof notStrictEqual;
deepEqual: typeof deepStrictEqual;
notDeepEqual: typeof notDeepStrictEqual;
-
// Mapped types and assertion functions are incompatible?
// TS2775: Assertions require every name in the call target
// to be declared with an explicit type annotation.
@@ -122,7 +957,6 @@ declare module 'assert' {
strict: typeof strict;
};
}
-
export = assert;
}
declare module 'node:assert' {
diff --git a/packages/node_modules/@node-red/editor-client/src/types/node/assert/strict.d.ts b/packages/node_modules/@node-red/editor-client/src/types/node/assert/strict.d.ts
new file mode 100644
index 000000000..ada209ced
--- /dev/null
+++ b/packages/node_modules/@node-red/editor-client/src/types/node/assert/strict.d.ts
@@ -0,0 +1,11 @@
+
+/* NOTE: Do not edit directly! This file is generated using `npm run update-types` in https://github.com/Steve-Mcl/monaco-editor-esm-i18n */
+
+declare module 'assert/strict' {
+ import { strict } from 'node:assert';
+ export = strict;
+}
+declare module 'node:assert/strict' {
+ import { strict } from 'node:assert';
+ export = strict;
+}
diff --git a/packages/node_modules/@node-red/editor-client/src/types/node/async_hooks.d.ts b/packages/node_modules/@node-red/editor-client/src/types/node/async_hooks.d.ts
index c576ec7c7..206104c55 100644
--- a/packages/node_modules/@node-red/editor-client/src/types/node/async_hooks.d.ts
+++ b/packages/node_modules/@node-red/editor-client/src/types/node/async_hooks.d.ts
@@ -2,18 +2,49 @@
/* NOTE: Do not edit directly! This file is generated using `npm run update-types` in https://github.com/Steve-Mcl/monaco-editor-esm-i18n */
/**
- * Async Hooks module: https://nodejs.org/api/async_hooks.html
+ * The `async_hooks` module provides an API to track asynchronous resources. It
+ * can be accessed using:
+ *
+ * ```js
+ * import async_hooks from 'async_hooks';
+ * ```
+ * @experimental
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/async_hooks.js)
*/
declare module 'async_hooks' {
/**
- * Returns the asyncId of the current execution context.
+ * ```js
+ * import { executionAsyncId } from 'async_hooks';
+ *
+ * console.log(executionAsyncId()); // 1 - bootstrap
+ * fs.open(path, 'r', (err, fd) => {
+ * console.log(executionAsyncId()); // 6 - open()
+ * });
+ * ```
+ *
+ * The ID returned from `executionAsyncId()` is related to execution timing, not
+ * causality (which is covered by `triggerAsyncId()`):
+ *
+ * ```js
+ * const server = net.createServer((conn) => {
+ * // Returns the ID of the server, not of the new connection, because the
+ * // callback runs in the execution scope of the server's MakeCallback().
+ * async_hooks.executionAsyncId();
+ *
+ * }).listen(port, () => {
+ * // Returns the ID of a TickObject (process.nextTick()) because all
+ * // callbacks passed to .listen() are wrapped in a nextTick().
+ * async_hooks.executionAsyncId();
+ * });
+ * ```
+ *
+ * Promise contexts may not get precise `executionAsyncIds` by default.
+ * See the section on `promise execution tracking`.
+ * @since v8.1.0
+ * @return The `asyncId` of the current execution context. Useful to track when something calls.
*/
function executionAsyncId(): number;
-
/**
- * The resource representing the current execution.
- * Useful to store data within the resource.
- *
* Resource objects returned by `executionAsyncResource()` are most often internal
* Node.js handle objects with undocumented APIs. Using any functions or properties
* on the object is likely to crash your application and should be avoided.
@@ -21,14 +52,70 @@ declare module 'async_hooks' {
* Using `executionAsyncResource()` in the top-level execution context will
* return an empty object as there is no handle or request object to use,
* but having an object representing the top-level can be helpful.
+ *
+ * ```js
+ * import { open } from 'fs';
+ * import { executionAsyncId, executionAsyncResource } from 'async_hooks';
+ *
+ * console.log(executionAsyncId(), executionAsyncResource()); // 1 {}
+ * open(new URL(import.meta.url), 'r', (err, fd) => {
+ * console.log(executionAsyncId(), executionAsyncResource()); // 7 FSReqWrap
+ * });
+ * ```
+ *
+ * This can be used to implement continuation local storage without the
+ * use of a tracking `Map` to store the metadata:
+ *
+ * ```js
+ * import { createServer } from 'http';
+ * import {
+ * executionAsyncId,
+ * executionAsyncResource,
+ * createHook
+ * } from 'async_hooks';
+ * const sym = Symbol('state'); // Private symbol to avoid pollution
+ *
+ * createHook({
+ * init(asyncId, type, triggerAsyncId, resource) {
+ * const cr = executionAsyncResource();
+ * if (cr) {
+ * resource[sym] = cr[sym];
+ * }
+ * }
+ * }).enable();
+ *
+ * const server = createServer((req, res) => {
+ * executionAsyncResource()[sym] = { state: req.url };
+ * setTimeout(function() {
+ * res.end(JSON.stringify(executionAsyncResource()[sym]));
+ * }, 100);
+ * }).listen(3000);
+ * ```
+ * @since v13.9.0, v12.17.0
+ * @return The resource representing the current execution. Useful to store data within the resource.
*/
function executionAsyncResource(): object;
-
/**
- * Returns the ID of the resource responsible for calling the callback that is currently being executed.
+ * ```js
+ * const server = net.createServer((conn) => {
+ * // The resource that caused (or triggered) this callback to be called
+ * // was that of the new connection. Thus the return value of triggerAsyncId()
+ * // is the asyncId of "conn".
+ * async_hooks.triggerAsyncId();
+ *
+ * }).listen(port, () => {
+ * // Even though all callbacks passed to .listen() are wrapped in a nextTick()
+ * // the callback itself exists because the call to the server's .listen()
+ * // was made. So the return value would be the ID of the server.
+ * async_hooks.triggerAsyncId();
+ * });
+ * ```
+ *
+ * Promise contexts may not get valid `triggerAsyncId`s by default. See
+ * the section on `promise execution tracking`.
+ * @return The ID of the resource responsible for calling the callback that is currently being executed.
*/
function triggerAsyncId(): number;
-
interface HookCallbacks {
/**
* Called when a class is constructed that has the possibility to emit an asynchronous event.
@@ -38,73 +125,133 @@ declare module 'async_hooks' {
* @param resource reference to the resource representing the async operation, needs to be released during destroy
*/
init?(asyncId: number, type: string, triggerAsyncId: number, resource: object): void;
-
/**
* When an asynchronous operation is initiated or completes a callback is called to notify the user.
* The before callback is called just before said callback is executed.
* @param asyncId the unique identifier assigned to the resource about to execute the callback.
*/
before?(asyncId: number): void;
-
/**
* Called immediately after the callback specified in before is completed.
* @param asyncId the unique identifier assigned to the resource which has executed the callback.
*/
after?(asyncId: number): void;
-
/**
* Called when a promise has resolve() called. This may not be in the same execution id
* as the promise itself.
* @param asyncId the unique id for the promise that was resolve()d.
*/
promiseResolve?(asyncId: number): void;
-
/**
* Called after the resource corresponding to asyncId is destroyed
* @param asyncId a unique ID for the async resource
*/
destroy?(asyncId: number): void;
}
-
interface AsyncHook {
/**
* Enable the callbacks for a given AsyncHook instance. If no callbacks are provided enabling is a noop.
*/
enable(): this;
-
/**
* Disable the callbacks for a given AsyncHook instance from the global pool of AsyncHook callbacks to be executed. Once a hook has been disabled it will not be called again until enabled.
*/
disable(): this;
}
-
/**
- * Registers functions to be called for different lifetime events of each async operation.
- * @param options the callbacks to register
- * @return an AsyncHooks instance used for disabling and enabling hooks
+ * Registers functions to be called for different lifetime events of each async
+ * operation.
+ *
+ * The callbacks `init()`/`before()`/`after()`/`destroy()` are called for the
+ * respective asynchronous event during a resource's lifetime.
+ *
+ * All callbacks are optional. For example, if only resource cleanup needs to
+ * be tracked, then only the `destroy` callback needs to be passed. The
+ * specifics of all functions that can be passed to `callbacks` is in the `Hook Callbacks` section.
+ *
+ * ```js
+ * import { createHook } from 'async_hooks';
+ *
+ * const asyncHook = createHook({
+ * init(asyncId, type, triggerAsyncId, resource) { },
+ * destroy(asyncId) { }
+ * });
+ * ```
+ *
+ * The callbacks will be inherited via the prototype chain:
+ *
+ * ```js
+ * class MyAsyncCallbacks {
+ * init(asyncId, type, triggerAsyncId, resource) { }
+ * destroy(asyncId) {}
+ * }
+ *
+ * class MyAddedCallbacks extends MyAsyncCallbacks {
+ * before(asyncId) { }
+ * after(asyncId) { }
+ * }
+ *
+ * const asyncHook = async_hooks.createHook(new MyAddedCallbacks());
+ * ```
+ *
+ * Because promises are asynchronous resources whose lifecycle is tracked
+ * via the async hooks mechanism, the `init()`, `before()`, `after()`, and`destroy()` callbacks _must not_ be async functions that return promises.
+ * @since v8.1.0
+ * @param callbacks The `Hook Callbacks` to register
+ * @return Instance used for disabling and enabling hooks
*/
- function createHook(options: HookCallbacks): AsyncHook;
-
+ function createHook(callbacks: HookCallbacks): AsyncHook;
interface AsyncResourceOptions {
- /**
- * The ID of the execution context that created this async event.
- * @default executionAsyncId()
- */
- triggerAsyncId?: number | undefined;
-
- /**
- * Disables automatic `emitDestroy` when the object is garbage collected.
- * This usually does not need to be set (even if `emitDestroy` is called
- * manually), unless the resource's `asyncId` is retrieved and the
- * sensitive API's `emitDestroy` is called with it.
- * @default false
- */
- requireManualDestroy?: boolean | undefined;
+ /**
+ * The ID of the execution context that created this async event.
+ * @default executionAsyncId()
+ */
+ triggerAsyncId?: number | undefined;
+ /**
+ * Disables automatic `emitDestroy` when the object is garbage collected.
+ * This usually does not need to be set (even if `emitDestroy` is called
+ * manually), unless the resource's `asyncId` is retrieved and the
+ * sensitive API's `emitDestroy` is called with it.
+ * @default false
+ */
+ requireManualDestroy?: boolean | undefined;
}
-
/**
- * The class AsyncResource was designed to be extended by the embedder's async resources.
- * Using this users can easily trigger the lifetime events of their own resources.
+ * The class `AsyncResource` is designed to be extended by the embedder's async
+ * resources. Using this, users can easily trigger the lifetime events of their
+ * own resources.
+ *
+ * The `init` hook will trigger when an `AsyncResource` is instantiated.
+ *
+ * The following is an overview of the `AsyncResource` API.
+ *
+ * ```js
+ * import { AsyncResource, executionAsyncId } from 'async_hooks';
+ *
+ * // AsyncResource() is meant to be extended. Instantiating a
+ * // new AsyncResource() also triggers init. If triggerAsyncId is omitted then
+ * // async_hook.executionAsyncId() is used.
+ * const asyncResource = new AsyncResource(
+ * type, { triggerAsyncId: executionAsyncId(), requireManualDestroy: false }
+ * );
+ *
+ * // Run a function in the execution context of the resource. This will
+ * // * establish the context of the resource
+ * // * trigger the AsyncHooks before callbacks
+ * // * call the provided function `fn` with the supplied arguments
+ * // * trigger the AsyncHooks after callbacks
+ * // * restore the original execution context
+ * asyncResource.runInAsyncScope(fn, thisArg, ...args);
+ *
+ * // Call AsyncHooks destroy callbacks.
+ * asyncResource.emitDestroy();
+ *
+ * // Return the unique ID assigned to the AsyncResource instance.
+ * asyncResource.asyncId();
+ *
+ * // Return the trigger ID for the AsyncResource instance.
+ * asyncResource.triggerAsyncId();
+ * ```
*/
class AsyncResource {
/**
@@ -114,115 +261,236 @@ declare module 'async_hooks' {
* @param type The type of async event.
* @param triggerAsyncId The ID of the execution context that created
* this async event (default: `executionAsyncId()`), or an
- * AsyncResourceOptions object (since 9.3)
+ * AsyncResourceOptions object (since v9.3.0)
*/
- constructor(type: string, triggerAsyncId?: number|AsyncResourceOptions);
-
+ constructor(type: string, triggerAsyncId?: number | AsyncResourceOptions);
/**
* Binds the given function to the current execution context.
+ *
+ * The returned function will have an `asyncResource` property referencing
+ * the `AsyncResource` to which the function is bound.
+ * @since v14.8.0, v12.19.0
* @param fn The function to bind to the current execution context.
* @param type An optional name to associate with the underlying `AsyncResource`.
*/
- static bind any>(fn: Func, type?: string): Func & { asyncResource: AsyncResource };
-
+ static bind any, ThisArg>(
+ fn: Func,
+ type?: string,
+ thisArg?: ThisArg
+ ): Func & {
+ asyncResource: AsyncResource;
+ };
/**
* Binds the given function to execute to this `AsyncResource`'s scope.
+ *
+ * The returned function will have an `asyncResource` property referencing
+ * the `AsyncResource` to which the function is bound.
+ * @since v14.8.0, v12.19.0
* @param fn The function to bind to the current `AsyncResource`.
*/
- bind any>(fn: Func): Func & { asyncResource: AsyncResource };
-
+ bind any>(
+ fn: Func
+ ): Func & {
+ asyncResource: AsyncResource;
+ };
/**
- * Call the provided function with the provided arguments in the
- * execution context of the async resource. This will establish the
- * context, trigger the AsyncHooks before callbacks, call the function,
- * trigger the AsyncHooks after callbacks, and then restore the original
- * execution context.
- * @param fn The function to call in the execution context of this
- * async resource.
+ * Call the provided function with the provided arguments in the execution context
+ * of the async resource. This will establish the context, trigger the AsyncHooks
+ * before callbacks, call the function, trigger the AsyncHooks after callbacks, and
+ * then restore the original execution context.
+ * @since v9.6.0
+ * @param fn The function to call in the execution context of this async resource.
* @param thisArg The receiver to be used for the function call.
* @param args Optional arguments to pass to the function.
*/
runInAsyncScope(fn: (this: This, ...args: any[]) => Result, thisArg?: This, ...args: any[]): Result;
-
/**
- * Call AsyncHooks destroy callbacks.
+ * Call all `destroy` hooks. This should only ever be called once. An error will
+ * be thrown if it is called more than once. This **must** be manually called. If
+ * the resource is left to be collected by the GC then the `destroy` hooks will
+ * never be called.
+ * @return A reference to `asyncResource`.
*/
emitDestroy(): this;
-
/**
- * @return the unique ID assigned to this AsyncResource instance.
+ * @return The unique `asyncId` assigned to the resource.
*/
asyncId(): number;
-
/**
- * @return the trigger ID for this AsyncResource instance.
+ *
+ * @return The same `triggerAsyncId` that is passed to the `AsyncResource` constructor.
*/
triggerAsyncId(): number;
}
-
/**
- * When having multiple instances of `AsyncLocalStorage`, they are independent
- * from each other. It is safe to instantiate this class multiple times.
+ * This class creates stores that stay coherent through asynchronous operations.
+ *
+ * While you can create your own implementation on top of the `async_hooks` module,`AsyncLocalStorage` should be preferred as it is a performant and memory safe
+ * implementation that involves significant optimizations that are non-obvious to
+ * implement.
+ *
+ * The following example uses `AsyncLocalStorage` to build a simple logger
+ * that assigns IDs to incoming HTTP requests and includes them in messages
+ * logged within each request.
+ *
+ * ```js
+ * import http from 'http';
+ * import { AsyncLocalStorage } from 'async_hooks';
+ *
+ * const asyncLocalStorage = new AsyncLocalStorage();
+ *
+ * function logWithId(msg) {
+ * const id = asyncLocalStorage.getStore();
+ * console.log(`${id !== undefined ? id : '-'}:`, msg);
+ * }
+ *
+ * let idSeq = 0;
+ * http.createServer((req, res) => {
+ * asyncLocalStorage.run(idSeq++, () => {
+ * logWithId('start');
+ * // Imagine any chain of async operations here
+ * setImmediate(() => {
+ * logWithId('finish');
+ * res.end();
+ * });
+ * });
+ * }).listen(8080);
+ *
+ * http.get('http://localhost:8080');
+ * http.get('http://localhost:8080');
+ * // Prints:
+ * // 0: start
+ * // 1: start
+ * // 0: finish
+ * // 1: finish
+ * ```
+ *
+ * Each instance of `AsyncLocalStorage` maintains an independent storage context.
+ * Multiple instances can safely exist simultaneously without risk of interfering
+ * with each other data.
+ * @since v13.10.0, v12.17.0
*/
class AsyncLocalStorage {
/**
- * This method disables the instance of `AsyncLocalStorage`. All subsequent calls
- * to `asyncLocalStorage.getStore()` will return `undefined` until
- * `asyncLocalStorage.run()` is called again.
+ * Disables the instance of `AsyncLocalStorage`. All subsequent calls
+ * to `asyncLocalStorage.getStore()` will return `undefined` until`asyncLocalStorage.run()` or `asyncLocalStorage.enterWith()` is called again.
*
* When calling `asyncLocalStorage.disable()`, all current contexts linked to the
* instance will be exited.
*
- * Calling `asyncLocalStorage.disable()` is required before the
- * `asyncLocalStorage` can be garbage collected. This does not apply to stores
+ * Calling `asyncLocalStorage.disable()` is required before the`asyncLocalStorage` can be garbage collected. This does not apply to stores
* provided by the `asyncLocalStorage`, as those objects are garbage collected
* along with the corresponding async resources.
*
- * This method is to be used when the `asyncLocalStorage` is not in use anymore
+ * Use this method when the `asyncLocalStorage` is not in use anymore
* in the current process.
+ * @since v13.10.0, v12.17.0
+ * @experimental
*/
disable(): void;
-
/**
- * This method returns the current store. If this method is called outside of an
- * asynchronous context initialized by calling `asyncLocalStorage.run`, it will
- * return `undefined`.
+ * Returns the current store.
+ * If called outside of an asynchronous context initialized by
+ * calling `asyncLocalStorage.run()` or `asyncLocalStorage.enterWith()`, it
+ * returns `undefined`.
+ * @since v13.10.0, v12.17.0
*/
getStore(): T | undefined;
-
/**
- * This methods runs a function synchronously within a context and return its
+ * Runs a function synchronously within a context and returns its
* return value. The store is not accessible outside of the callback function or
* the asynchronous operations created within the callback.
*
- * Optionally, arguments can be passed to the function. They will be passed to the
- * callback function.
+ * The optional `args` are passed to the callback function.
*
- * I the callback function throws an error, it will be thrown by `run` too. The
- * stacktrace will not be impacted by this call and the context will be exited.
+ * If the callback function throws an error, the error is thrown by `run()` too.
+ * The stacktrace is not impacted by this call and the context is exited.
+ *
+ * Example:
+ *
+ * ```js
+ * const store = { id: 2 };
+ * try {
+ * asyncLocalStorage.run(store, () => {
+ * asyncLocalStorage.getStore(); // Returns the store object
+ * throw new Error();
+ * });
+ * } catch (e) {
+ * asyncLocalStorage.getStore(); // Returns undefined
+ * // The error will be caught here
+ * }
+ * ```
+ * @since v13.10.0, v12.17.0
*/
- // TODO: Apply generic vararg once available
- run(store: T, callback: (...args: any[]) => R, ...args: any[]): R;
-
+ run(store: T, callback: (...args: TArgs) => R, ...args: TArgs): R;
/**
- * This methods runs a function synchronously outside of a context and return its
- * return value. The store is not accessible within the callback function or the
- * asynchronous operations created within the callback.
+ * Runs a function synchronously outside of a context and returns its
+ * return value. The store is not accessible within the callback function or
+ * the asynchronous operations created within the callback. Any `getStore()`call done within the callback function will always return `undefined`.
*
- * Optionally, arguments can be passed to the function. They will be passed to the
- * callback function.
+ * The optional `args` are passed to the callback function.
*
- * If the callback function throws an error, it will be thrown by `exit` too. The
- * stacktrace will not be impacted by this call and the context will be
- * re-entered.
+ * If the callback function throws an error, the error is thrown by `exit()` too.
+ * The stacktrace is not impacted by this call and the context is re-entered.
+ *
+ * Example:
+ *
+ * ```js
+ * // Within a call to run
+ * try {
+ * asyncLocalStorage.getStore(); // Returns the store object or value
+ * asyncLocalStorage.exit(() => {
+ * asyncLocalStorage.getStore(); // Returns undefined
+ * throw new Error();
+ * });
+ * } catch (e) {
+ * asyncLocalStorage.getStore(); // Returns the same object or value
+ * // The error will be caught here
+ * }
+ * ```
+ * @since v13.10.0, v12.17.0
+ * @experimental
*/
- // TODO: Apply generic vararg once available
- exit(callback: (...args: any[]) => R, ...args: any[]): R;
-
+ exit(callback: (...args: TArgs) => R, ...args: TArgs): R;
/**
- * Calling `asyncLocalStorage.enterWith(store)` will transition into the context
- * for the remainder of the current synchronous execution and will persist
- * through any following asynchronous calls.
+ * Transitions into the context for the remainder of the current
+ * synchronous execution and then persists the store through any following
+ * asynchronous calls.
+ *
+ * Example:
+ *
+ * ```js
+ * const store = { id: 1 };
+ * // Replaces previous store with the given store object
+ * asyncLocalStorage.enterWith(store);
+ * asyncLocalStorage.getStore(); // Returns the store object
+ * someAsyncOperation(() => {
+ * asyncLocalStorage.getStore(); // Returns the same object
+ * });
+ * ```
+ *
+ * This transition will continue for the _entire_ synchronous execution.
+ * This means that if, for example, the context is entered within an event
+ * handler subsequent event handlers will also run within that context unless
+ * specifically bound to another context with an `AsyncResource`. That is why`run()` should be preferred over `enterWith()` unless there are strong reasons
+ * to use the latter method.
+ *
+ * ```js
+ * const store = { id: 1 };
+ *
+ * emitter.on('my-event', () => {
+ * asyncLocalStorage.enterWith(store);
+ * });
+ * emitter.on('my-event', () => {
+ * asyncLocalStorage.getStore(); // Returns the same object
+ * });
+ *
+ * asyncLocalStorage.getStore(); // Returns undefined
+ * emitter.emit('my-event');
+ * asyncLocalStorage.getStore(); // Returns the same object
+ * ```
+ * @since v13.11.0, v12.17.0
+ * @experimental
*/
enterWith(store: T): void;
}
diff --git a/packages/node_modules/@node-red/editor-client/src/types/node/buffer.d.ts b/packages/node_modules/@node-red/editor-client/src/types/node/buffer.d.ts
index 24a77e1e4..e04af96e7 100644
--- a/packages/node_modules/@node-red/editor-client/src/types/node/buffer.d.ts
+++ b/packages/node_modules/@node-red/editor-client/src/types/node/buffer.d.ts
@@ -1,8 +1,54 @@
/* NOTE: Do not edit directly! This file is generated using `npm run update-types` in https://github.com/Steve-Mcl/monaco-editor-esm-i18n */
+/**
+ * `Buffer` objects are used to represent a fixed-length sequence of bytes. Many
+ * Node.js APIs support `Buffer`s.
+ *
+ * The `Buffer` class is a subclass of JavaScript's [`Uint8Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) class and
+ * extends it with methods that cover additional use cases. Node.js APIs accept
+ * plain [`Uint8Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array) s wherever `Buffer`s are supported as well.
+ *
+ * While the `Buffer` class is available within the global scope, it is still
+ * recommended to explicitly reference it via an import or require statement.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * // Creates a zero-filled Buffer of length 10.
+ * const buf1 = Buffer.alloc(10);
+ *
+ * // Creates a Buffer of length 10,
+ * // filled with bytes which all have the value `1`.
+ * const buf2 = Buffer.alloc(10, 1);
+ *
+ * // Creates an uninitialized buffer of length 10.
+ * // This is faster than calling Buffer.alloc() but the returned
+ * // Buffer instance might contain old data that needs to be
+ * // overwritten using fill(), write(), or other functions that fill the Buffer's
+ * // contents.
+ * const buf3 = Buffer.allocUnsafe(10);
+ *
+ * // Creates a Buffer containing the bytes [1, 2, 3].
+ * const buf4 = Buffer.from([1, 2, 3]);
+ *
+ * // Creates a Buffer containing the bytes [1, 1, 1, 1] – the entries
+ * // are all truncated using `(value & 255)` to fit into the range 0–255.
+ * const buf5 = Buffer.from([257, 257.5, -255, '1']);
+ *
+ * // Creates a Buffer containing the UTF-8-encoded bytes for the string 'tést':
+ * // [0x74, 0xc3, 0xa9, 0x73, 0x74] (in hexadecimal notation)
+ * // [116, 195, 169, 115, 116] (in decimal notation)
+ * const buf6 = Buffer.from('tést');
+ *
+ * // Creates a Buffer containing the Latin-1 bytes [0x74, 0xe9, 0x73, 0x74].
+ * const buf7 = Buffer.from('tést', 'latin1');
+ * ```
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/buffer.js)
+ */
declare module 'buffer' {
import { BinaryLike } from 'node:crypto';
+ import { ReadableStream as WebReadableStream } from 'node:stream/web';
export const INSPECT_MAX_BYTES: number;
export const kMaxLength: number;
export const kStringMaxLength: number;
@@ -10,17 +56,49 @@ declare module 'buffer' {
MAX_LENGTH: number;
MAX_STRING_LENGTH: number;
};
- const BuffType: typeof Buffer;
-
- export type TranscodeEncoding = "ascii" | "utf8" | "utf16le" | "ucs2" | "latin1" | "binary";
-
+ export type TranscodeEncoding = 'ascii' | 'utf8' | 'utf16le' | 'ucs2' | 'latin1' | 'binary';
+ /**
+ * Re-encodes the given `Buffer` or `Uint8Array` instance from one character
+ * encoding to another. Returns a new `Buffer` instance.
+ *
+ * Throws if the `fromEnc` or `toEnc` specify invalid character encodings or if
+ * conversion from `fromEnc` to `toEnc` is not permitted.
+ *
+ * Encodings supported by `buffer.transcode()` are: `'ascii'`, `'utf8'`,`'utf16le'`, `'ucs2'`, `'latin1'`, and `'binary'`.
+ *
+ * The transcoding process will use substitution characters if a given byte
+ * sequence cannot be adequately represented in the target encoding. For instance:
+ *
+ * ```js
+ * import { Buffer, transcode } from 'buffer';
+ *
+ * const newBuf = transcode(Buffer.from('€'), 'utf8', 'ascii');
+ * console.log(newBuf.toString('ascii'));
+ * // Prints: '?'
+ * ```
+ *
+ * Because the Euro (`€`) sign is not representable in US-ASCII, it is replaced
+ * with `?` in the transcoded `Buffer`.
+ * @since v7.1.0
+ * @param source A `Buffer` or `Uint8Array` instance.
+ * @param fromEnc The current encoding.
+ * @param toEnc To target encoding.
+ */
export function transcode(source: Uint8Array, fromEnc: TranscodeEncoding, toEnc: TranscodeEncoding): Buffer;
-
export const SlowBuffer: {
/** @deprecated since v6.0.0, use `Buffer.allocUnsafeSlow()` */
- new(size: number): Buffer;
+ new (size: number): Buffer;
prototype: Buffer;
};
+ /**
+ * Resolves a `'blob:nodedata:...'` an associated `Blob` object registered using
+ * a prior call to `URL.createObjectURL()`.
+ * @since v16.7.0
+ * @experimental
+ * @param id A `'blob:nodedata:...` URL string returned by a prior call to `URL.createObjectURL()`.
+ */
+ export function resolveObjectURL(id: string): Blob | undefined;
+ export { Buffer };
/**
* @experimental
*/
@@ -39,18 +117,18 @@ declare module 'buffer' {
/**
* A [`Blob`](https://developer.mozilla.org/en-US/docs/Web/API/Blob) encapsulates immutable, raw data that can be safely shared across
* multiple worker threads.
- * @since v14.18.0
+ * @since v15.7.0
* @experimental
*/
export class Blob {
/**
* The total size of the `Blob` in bytes.
- * @since v14.18.0
+ * @since v15.7.0
*/
readonly size: number;
/**
* The content-type of the `Blob`.
- * @since v14.18.0
+ * @since v15.7.0
*/
readonly type: string;
/**
@@ -65,13 +143,13 @@ declare module 'buffer' {
/**
* Returns a promise that fulfills with an [ArrayBuffer](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer) containing a copy of
* the `Blob` data.
- * @since v14.18.0
+ * @since v15.7.0
*/
arrayBuffer(): Promise;
/**
* Creates and returns a new `Blob` containing a subset of this `Blob` objects
* data. The original `Blob` is not altered.
- * @since v14.18.0
+ * @since v15.7.0
* @param start The starting index.
* @param end The ending index.
* @param type The content-type for the new `Blob`
@@ -80,12 +158,2078 @@ declare module 'buffer' {
/**
* Returns a promise that fulfills with the contents of the `Blob` decoded as a
* UTF-8 string.
- * @since v14.18.0
+ * @since v15.7.0
*/
text(): Promise;
+ /**
+ * Returns a new (WHATWG) `ReadableStream` that allows the content of the `Blob` to be read.
+ * @since v16.7.0
+ */
+ stream(): WebReadableStream;
+ }
+ export import atob = globalThis.atob;
+ export import btoa = globalThis.btoa;
+ global {
+ // Buffer class
+ type BufferEncoding = 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'base64url' | 'latin1' | 'binary' | 'hex';
+ type WithImplicitCoercion =
+ | T
+ | {
+ valueOf(): T;
+ };
+ /**
+ * Raw data is stored in instances of the Buffer class.
+ * A Buffer is similar to an array of integers but corresponds to a raw memory allocation outside the V8 heap. A Buffer cannot be resized.
+ * Valid string encodings: 'ascii'|'utf8'|'utf16le'|'ucs2'(alias of 'utf16le')|'base64'|'base64url'|'binary'(deprecated)|'hex'
+ */
+ interface BufferConstructor {
+ /**
+ * Allocates a new buffer containing the given {str}.
+ *
+ * @param str String to store in buffer.
+ * @param encoding encoding to use, optional. Default is 'utf8'
+ * @deprecated since v10.0.0 - Use `Buffer.from(string[, encoding])` instead.
+ */
+ new (str: string, encoding?: BufferEncoding): Buffer;
+ /**
+ * Allocates a new buffer of {size} octets.
+ *
+ * @param size count of octets to allocate.
+ * @deprecated since v10.0.0 - Use `Buffer.alloc()` instead (also see `Buffer.allocUnsafe()`).
+ */
+ new (size: number): Buffer;
+ /**
+ * Allocates a new buffer containing the given {array} of octets.
+ *
+ * @param array The octets to store.
+ * @deprecated since v10.0.0 - Use `Buffer.from(array)` instead.
+ */
+ new (array: Uint8Array): Buffer;
+ /**
+ * Produces a Buffer backed by the same allocated memory as
+ * the given {ArrayBuffer}/{SharedArrayBuffer}.
+ *
+ *
+ * @param arrayBuffer The ArrayBuffer with which to share memory.
+ * @deprecated since v10.0.0 - Use `Buffer.from(arrayBuffer[, byteOffset[, length]])` instead.
+ */
+ new (arrayBuffer: ArrayBuffer | SharedArrayBuffer): Buffer;
+ /**
+ * Allocates a new buffer containing the given {array} of octets.
+ *
+ * @param array The octets to store.
+ * @deprecated since v10.0.0 - Use `Buffer.from(array)` instead.
+ */
+ new (array: ReadonlyArray): Buffer;
+ /**
+ * Copies the passed {buffer} data onto a new {Buffer} instance.
+ *
+ * @param buffer The buffer to copy.
+ * @deprecated since v10.0.0 - Use `Buffer.from(buffer)` instead.
+ */
+ new (buffer: Buffer): Buffer;
+ /**
+ * Allocates a new `Buffer` using an `array` of bytes in the range `0` – `255`.
+ * Array entries outside that range will be truncated to fit into it.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * // Creates a new Buffer containing the UTF-8 bytes of the string 'buffer'.
+ * const buf = Buffer.from([0x62, 0x75, 0x66, 0x66, 0x65, 0x72]);
+ * ```
+ *
+ * A `TypeError` will be thrown if `array` is not an `Array` or another type
+ * appropriate for `Buffer.from()` variants.
+ *
+ * `Buffer.from(array)` and `Buffer.from(string)` may also use the internal`Buffer` pool like `Buffer.allocUnsafe()` does.
+ * @since v5.10.0
+ */
+ from(arrayBuffer: WithImplicitCoercion, byteOffset?: number, length?: number): Buffer;
+ /**
+ * Creates a new Buffer using the passed {data}
+ * @param data data to create a new Buffer
+ */
+ from(data: Uint8Array | ReadonlyArray): Buffer;
+ from(data: WithImplicitCoercion | string>): Buffer;
+ /**
+ * Creates a new Buffer containing the given JavaScript string {str}.
+ * If provided, the {encoding} parameter identifies the character encoding.
+ * If not provided, {encoding} defaults to 'utf8'.
+ */
+ from(
+ str:
+ | WithImplicitCoercion
+ | {
+ [Symbol.toPrimitive](hint: 'string'): string;
+ },
+ encoding?: BufferEncoding
+ ): Buffer;
+ /**
+ * Creates a new Buffer using the passed {data}
+ * @param values to create a new Buffer
+ */
+ of(...items: number[]): Buffer;
+ /**
+ * Returns `true` if `obj` is a `Buffer`, `false` otherwise.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * Buffer.isBuffer(Buffer.alloc(10)); // true
+ * Buffer.isBuffer(Buffer.from('foo')); // true
+ * Buffer.isBuffer('a string'); // false
+ * Buffer.isBuffer([]); // false
+ * Buffer.isBuffer(new Uint8Array(1024)); // false
+ * ```
+ * @since v0.1.101
+ */
+ isBuffer(obj: any): obj is Buffer;
+ /**
+ * Returns `true` if `encoding` is the name of a supported character encoding,
+ * or `false` otherwise.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * console.log(Buffer.isEncoding('utf8'));
+ * // Prints: true
+ *
+ * console.log(Buffer.isEncoding('hex'));
+ * // Prints: true
+ *
+ * console.log(Buffer.isEncoding('utf/8'));
+ * // Prints: false
+ *
+ * console.log(Buffer.isEncoding(''));
+ * // Prints: false
+ * ```
+ * @since v0.9.1
+ * @param encoding A character encoding name to check.
+ */
+ isEncoding(encoding: string): encoding is BufferEncoding;
+ /**
+ * Returns the byte length of a string when encoded using `encoding`.
+ * This is not the same as [`String.prototype.length`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/length), which does not account
+ * for the encoding that is used to convert the string into bytes.
+ *
+ * For `'base64'`, `'base64url'`, and `'hex'`, this function assumes valid input.
+ * For strings that contain non-base64/hex-encoded data (e.g. whitespace), the
+ * return value might be greater than the length of a `Buffer` created from the
+ * string.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const str = '\u00bd + \u00bc = \u00be';
+ *
+ * console.log(`${str}: ${str.length} characters, ` +
+ * `${Buffer.byteLength(str, 'utf8')} bytes`);
+ * // Prints: ½ + ¼ = ¾: 9 characters, 12 bytes
+ * ```
+ *
+ * When `string` is a
+ * `Buffer`/[`DataView`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView)/[`TypedArray`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/-
+ * Reference/Global_Objects/TypedArray)/[`ArrayBuffer`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer)/[`SharedArrayBuffer`](https://develop-
+ * er.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer), the byte length as reported by `.byteLength`is returned.
+ * @since v0.1.90
+ * @param string A value to calculate the length of.
+ * @param [encoding='utf8'] If `string` is a string, this is its encoding.
+ * @return The number of bytes contained within `string`.
+ */
+ byteLength(string: string | NodeJS.ArrayBufferView | ArrayBuffer | SharedArrayBuffer, encoding?: BufferEncoding): number;
+ /**
+ * Returns a new `Buffer` which is the result of concatenating all the `Buffer`instances in the `list` together.
+ *
+ * If the list has no items, or if the `totalLength` is 0, then a new zero-length`Buffer` is returned.
+ *
+ * If `totalLength` is not provided, it is calculated from the `Buffer` instances
+ * in `list` by adding their lengths.
+ *
+ * If `totalLength` is provided, it is coerced to an unsigned integer. If the
+ * combined length of the `Buffer`s in `list` exceeds `totalLength`, the result is
+ * truncated to `totalLength`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * // Create a single `Buffer` from a list of three `Buffer` instances.
+ *
+ * const buf1 = Buffer.alloc(10);
+ * const buf2 = Buffer.alloc(14);
+ * const buf3 = Buffer.alloc(18);
+ * const totalLength = buf1.length + buf2.length + buf3.length;
+ *
+ * console.log(totalLength);
+ * // Prints: 42
+ *
+ * const bufA = Buffer.concat([buf1, buf2, buf3], totalLength);
+ *
+ * console.log(bufA);
+ * // Prints:
+ * console.log(bufA.length);
+ * // Prints: 42
+ * ```
+ *
+ * `Buffer.concat()` may also use the internal `Buffer` pool like `Buffer.allocUnsafe()` does.
+ * @since v0.7.11
+ * @param list List of `Buffer` or {@link Uint8Array} instances to concatenate.
+ * @param totalLength Total length of the `Buffer` instances in `list` when concatenated.
+ */
+ concat(list: ReadonlyArray, totalLength?: number): Buffer;
+ /**
+ * Compares `buf1` to `buf2`, typically for the purpose of sorting arrays of`Buffer` instances. This is equivalent to calling `buf1.compare(buf2)`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf1 = Buffer.from('1234');
+ * const buf2 = Buffer.from('0123');
+ * const arr = [buf1, buf2];
+ *
+ * console.log(arr.sort(Buffer.compare));
+ * // Prints: [ , ]
+ * // (This result is equal to: [buf2, buf1].)
+ * ```
+ * @since v0.11.13
+ * @return Either `-1`, `0`, or `1`, depending on the result of the comparison. See `compare` for details.
+ */
+ compare(buf1: Uint8Array, buf2: Uint8Array): number;
+ /**
+ * Allocates a new `Buffer` of `size` bytes. If `fill` is `undefined`, the`Buffer` will be zero-filled.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.alloc(5);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ *
+ * If `size` is larger than {@link constants.MAX_LENGTH} or smaller than 0, `ERR_INVALID_ARG_VALUE` is thrown.
+ *
+ * If `fill` is specified, the allocated `Buffer` will be initialized by calling `buf.fill(fill)`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.alloc(5, 'a');
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ *
+ * If both `fill` and `encoding` are specified, the allocated `Buffer` will be
+ * initialized by calling `buf.fill(fill, encoding)`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.alloc(11, 'aGVsbG8gd29ybGQ=', 'base64');
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ *
+ * Calling `Buffer.alloc()` can be measurably slower than the alternative `Buffer.allocUnsafe()` but ensures that the newly created `Buffer` instance
+ * contents will never contain sensitive data from previous allocations, including
+ * data that might not have been allocated for `Buffer`s.
+ *
+ * A `TypeError` will be thrown if `size` is not a number.
+ * @since v5.10.0
+ * @param size The desired length of the new `Buffer`.
+ * @param [fill=0] A value to pre-fill the new `Buffer` with.
+ * @param [encoding='utf8'] If `fill` is a string, this is its encoding.
+ */
+ alloc(size: number, fill?: string | Buffer | number, encoding?: BufferEncoding): Buffer;
+ /**
+ * Allocates a new `Buffer` of `size` bytes. If `size` is larger than {@link constants.MAX_LENGTH} or smaller than 0, `ERR_INVALID_ARG_VALUE` is thrown.
+ *
+ * The underlying memory for `Buffer` instances created in this way is _not_
+ * _initialized_. The contents of the newly created `Buffer` are unknown and_may contain sensitive data_. Use `Buffer.alloc()` instead to initialize`Buffer` instances with zeroes.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(10);
+ *
+ * console.log(buf);
+ * // Prints (contents may vary):
+ *
+ * buf.fill(0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ *
+ * A `TypeError` will be thrown if `size` is not a number.
+ *
+ * The `Buffer` module pre-allocates an internal `Buffer` instance of
+ * size `Buffer.poolSize` that is used as a pool for the fast allocation of new`Buffer` instances created using `Buffer.allocUnsafe()`,`Buffer.from(array)`, `Buffer.concat()`, and the
+ * deprecated`new Buffer(size)` constructor only when `size` is less than or equal
+ * to `Buffer.poolSize >> 1` (floor of `Buffer.poolSize` divided by two).
+ *
+ * Use of this pre-allocated internal memory pool is a key difference between
+ * calling `Buffer.alloc(size, fill)` vs. `Buffer.allocUnsafe(size).fill(fill)`.
+ * Specifically, `Buffer.alloc(size, fill)` will _never_ use the internal `Buffer`pool, while `Buffer.allocUnsafe(size).fill(fill)`_will_ use the internal`Buffer` pool if `size` is less
+ * than or equal to half `Buffer.poolSize`. The
+ * difference is subtle but can be important when an application requires the
+ * additional performance that `Buffer.allocUnsafe()` provides.
+ * @since v5.10.0
+ * @param size The desired length of the new `Buffer`.
+ */
+ allocUnsafe(size: number): Buffer;
+ /**
+ * Allocates a new `Buffer` of `size` bytes. If `size` is larger than {@link constants.MAX_LENGTH} or smaller than 0, `ERR_INVALID_ARG_VALUE` is thrown. A zero-length `Buffer` is created
+ * if `size` is 0.
+ *
+ * The underlying memory for `Buffer` instances created in this way is _not_
+ * _initialized_. The contents of the newly created `Buffer` are unknown and_may contain sensitive data_. Use `buf.fill(0)` to initialize
+ * such `Buffer` instances with zeroes.
+ *
+ * When using `Buffer.allocUnsafe()` to allocate new `Buffer` instances,
+ * allocations under 4 KB are sliced from a single pre-allocated `Buffer`. This
+ * allows applications to avoid the garbage collection overhead of creating many
+ * individually allocated `Buffer` instances. This approach improves both
+ * performance and memory usage by eliminating the need to track and clean up as
+ * many individual `ArrayBuffer` objects.
+ *
+ * However, in the case where a developer may need to retain a small chunk of
+ * memory from a pool for an indeterminate amount of time, it may be appropriate
+ * to create an un-pooled `Buffer` instance using `Buffer.allocUnsafeSlow()` and
+ * then copying out the relevant bits.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * // Need to keep around a few small chunks of memory.
+ * const store = [];
+ *
+ * socket.on('readable', () => {
+ * let data;
+ * while (null !== (data = readable.read())) {
+ * // Allocate for retained data.
+ * const sb = Buffer.allocUnsafeSlow(10);
+ *
+ * // Copy the data into the new allocation.
+ * data.copy(sb, 0, 0, 10);
+ *
+ * store.push(sb);
+ * }
+ * });
+ * ```
+ *
+ * A `TypeError` will be thrown if `size` is not a number.
+ * @since v5.12.0
+ * @param size The desired length of the new `Buffer`.
+ */
+ allocUnsafeSlow(size: number): Buffer;
+ /**
+ * This is the size (in bytes) of pre-allocated internal `Buffer` instances used
+ * for pooling. This value may be modified.
+ * @since v0.11.3
+ */
+ poolSize: number;
+ }
+ interface Buffer extends Uint8Array {
+ /**
+ * Writes `string` to `buf` at `offset` according to the character encoding in`encoding`. The `length` parameter is the number of bytes to write. If `buf` did
+ * not contain enough space to fit the entire string, only part of `string` will be
+ * written. However, partially encoded characters will not be written.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.alloc(256);
+ *
+ * const len = buf.write('\u00bd + \u00bc = \u00be', 0);
+ *
+ * console.log(`${len} bytes: ${buf.toString('utf8', 0, len)}`);
+ * // Prints: 12 bytes: ½ + ¼ = ¾
+ *
+ * const buffer = Buffer.alloc(10);
+ *
+ * const length = buffer.write('abcd', 8);
+ *
+ * console.log(`${length} bytes: ${buffer.toString('utf8', 8, 10)}`);
+ * // Prints: 2 bytes : ab
+ * ```
+ * @since v0.1.90
+ * @param string String to write to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write `string`.
+ * @param [length=buf.length - offset] Maximum number of bytes to write (written bytes will not exceed `buf.length - offset`).
+ * @param [encoding='utf8'] The character encoding of `string`.
+ * @return Number of bytes written.
+ */
+ write(string: string, encoding?: BufferEncoding): number;
+ write(string: string, offset: number, encoding?: BufferEncoding): number;
+ write(string: string, offset: number, length: number, encoding?: BufferEncoding): number;
+ /**
+ * Decodes `buf` to a string according to the specified character encoding in`encoding`. `start` and `end` may be passed to decode only a subset of `buf`.
+ *
+ * If `encoding` is `'utf8'` and a byte sequence in the input is not valid UTF-8,
+ * then each invalid byte is replaced with the replacement character `U+FFFD`.
+ *
+ * The maximum length of a string instance (in UTF-16 code units) is available
+ * as {@link constants.MAX_STRING_LENGTH}.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf1 = Buffer.allocUnsafe(26);
+ *
+ * for (let i = 0; i < 26; i++) {
+ * // 97 is the decimal ASCII value for 'a'.
+ * buf1[i] = i + 97;
+ * }
+ *
+ * console.log(buf1.toString('utf8'));
+ * // Prints: abcdefghijklmnopqrstuvwxyz
+ * console.log(buf1.toString('utf8', 0, 5));
+ * // Prints: abcde
+ *
+ * const buf2 = Buffer.from('tést');
+ *
+ * console.log(buf2.toString('hex'));
+ * // Prints: 74c3a97374
+ * console.log(buf2.toString('utf8', 0, 3));
+ * // Prints: té
+ * console.log(buf2.toString(undefined, 0, 3));
+ * // Prints: té
+ * ```
+ * @since v0.1.90
+ * @param [encoding='utf8'] The character encoding to use.
+ * @param [start=0] The byte offset to start decoding at.
+ * @param [end=buf.length] The byte offset to stop decoding at (not inclusive).
+ */
+ toString(encoding?: BufferEncoding, start?: number, end?: number): string;
+ /**
+ * Returns a JSON representation of `buf`. [`JSON.stringify()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify) implicitly calls
+ * this function when stringifying a `Buffer` instance.
+ *
+ * `Buffer.from()` accepts objects in the format returned from this method.
+ * In particular, `Buffer.from(buf.toJSON())` works like `Buffer.from(buf)`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5]);
+ * const json = JSON.stringify(buf);
+ *
+ * console.log(json);
+ * // Prints: {"type":"Buffer","data":[1,2,3,4,5]}
+ *
+ * const copy = JSON.parse(json, (key, value) => {
+ * return value && value.type === 'Buffer' ?
+ * Buffer.from(value) :
+ * value;
+ * });
+ *
+ * console.log(copy);
+ * // Prints:
+ * ```
+ * @since v0.9.2
+ */
+ toJSON(): {
+ type: 'Buffer';
+ data: number[];
+ };
+ /**
+ * Returns `true` if both `buf` and `otherBuffer` have exactly the same bytes,`false` otherwise. Equivalent to `buf.compare(otherBuffer) === 0`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf1 = Buffer.from('ABC');
+ * const buf2 = Buffer.from('414243', 'hex');
+ * const buf3 = Buffer.from('ABCD');
+ *
+ * console.log(buf1.equals(buf2));
+ * // Prints: true
+ * console.log(buf1.equals(buf3));
+ * // Prints: false
+ * ```
+ * @since v0.11.13
+ * @param otherBuffer A `Buffer` or {@link Uint8Array} with which to compare `buf`.
+ */
+ equals(otherBuffer: Uint8Array): boolean;
+ /**
+ * Compares `buf` with `target` and returns a number indicating whether `buf`comes before, after, or is the same as `target` in sort order.
+ * Comparison is based on the actual sequence of bytes in each `Buffer`.
+ *
+ * * `0` is returned if `target` is the same as `buf`
+ * * `1` is returned if `target` should come _before_`buf` when sorted.
+ * * `-1` is returned if `target` should come _after_`buf` when sorted.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf1 = Buffer.from('ABC');
+ * const buf2 = Buffer.from('BCD');
+ * const buf3 = Buffer.from('ABCD');
+ *
+ * console.log(buf1.compare(buf1));
+ * // Prints: 0
+ * console.log(buf1.compare(buf2));
+ * // Prints: -1
+ * console.log(buf1.compare(buf3));
+ * // Prints: -1
+ * console.log(buf2.compare(buf1));
+ * // Prints: 1
+ * console.log(buf2.compare(buf3));
+ * // Prints: 1
+ * console.log([buf1, buf2, buf3].sort(Buffer.compare));
+ * // Prints: [ , , ]
+ * // (This result is equal to: [buf1, buf3, buf2].)
+ * ```
+ *
+ * The optional `targetStart`, `targetEnd`, `sourceStart`, and `sourceEnd`arguments can be used to limit the comparison to specific ranges within `target`and `buf` respectively.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf1 = Buffer.from([1, 2, 3, 4, 5, 6, 7, 8, 9]);
+ * const buf2 = Buffer.from([5, 6, 7, 8, 9, 1, 2, 3, 4]);
+ *
+ * console.log(buf1.compare(buf2, 5, 9, 0, 4));
+ * // Prints: 0
+ * console.log(buf1.compare(buf2, 0, 6, 4));
+ * // Prints: -1
+ * console.log(buf1.compare(buf2, 5, 6, 5));
+ * // Prints: 1
+ * ```
+ *
+ * `ERR_OUT_OF_RANGE` is thrown if `targetStart < 0`, `sourceStart < 0`,`targetEnd > target.byteLength`, or `sourceEnd > source.byteLength`.
+ * @since v0.11.13
+ * @param target A `Buffer` or {@link Uint8Array} with which to compare `buf`.
+ * @param [targetStart=0] The offset within `target` at which to begin comparison.
+ * @param [targetEnd=target.length] The offset within `target` at which to end comparison (not inclusive).
+ * @param [sourceStart=0] The offset within `buf` at which to begin comparison.
+ * @param [sourceEnd=buf.length] The offset within `buf` at which to end comparison (not inclusive).
+ */
+ compare(target: Uint8Array, targetStart?: number, targetEnd?: number, sourceStart?: number, sourceEnd?: number): number;
+ /**
+ * Copies data from a region of `buf` to a region in `target`, even if the `target`memory region overlaps with `buf`.
+ *
+ * [`TypedArray.prototype.set()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/set) performs the same operation, and is available
+ * for all TypedArrays, including Node.js `Buffer`s, although it takes
+ * different function arguments.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * // Create two `Buffer` instances.
+ * const buf1 = Buffer.allocUnsafe(26);
+ * const buf2 = Buffer.allocUnsafe(26).fill('!');
+ *
+ * for (let i = 0; i < 26; i++) {
+ * // 97 is the decimal ASCII value for 'a'.
+ * buf1[i] = i + 97;
+ * }
+ *
+ * // Copy `buf1` bytes 16 through 19 into `buf2` starting at byte 8 of `buf2`.
+ * buf1.copy(buf2, 8, 16, 20);
+ * // This is equivalent to:
+ * // buf2.set(buf1.subarray(16, 20), 8);
+ *
+ * console.log(buf2.toString('ascii', 0, 25));
+ * // Prints: !!!!!!!!qrst!!!!!!!!!!!!!
+ * ```
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * // Create a `Buffer` and copy data from one region to an overlapping region
+ * // within the same `Buffer`.
+ *
+ * const buf = Buffer.allocUnsafe(26);
+ *
+ * for (let i = 0; i < 26; i++) {
+ * // 97 is the decimal ASCII value for 'a'.
+ * buf[i] = i + 97;
+ * }
+ *
+ * buf.copy(buf, 0, 4, 10);
+ *
+ * console.log(buf.toString());
+ * // Prints: efghijghijklmnopqrstuvwxyz
+ * ```
+ * @since v0.1.90
+ * @param target A `Buffer` or {@link Uint8Array} to copy into.
+ * @param [targetStart=0] The offset within `target` at which to begin writing.
+ * @param [sourceStart=0] The offset within `buf` from which to begin copying.
+ * @param [sourceEnd=buf.length] The offset within `buf` at which to stop copying (not inclusive).
+ * @return The number of bytes copied.
+ */
+ copy(target: Uint8Array, targetStart?: number, sourceStart?: number, sourceEnd?: number): number;
+ /**
+ * Returns a new `Buffer` that references the same memory as the original, but
+ * offset and cropped by the `start` and `end` indices.
+ *
+ * This is the same behavior as `buf.subarray()`.
+ *
+ * This method is not compatible with the `Uint8Array.prototype.slice()`,
+ * which is a superclass of `Buffer`. To copy the slice, use`Uint8Array.prototype.slice()`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from('buffer');
+ *
+ * const copiedBuf = Uint8Array.prototype.slice.call(buf);
+ * copiedBuf[0]++;
+ * console.log(copiedBuf.toString());
+ * // Prints: cuffer
+ *
+ * console.log(buf.toString());
+ * // Prints: buffer
+ * ```
+ * @since v0.3.0
+ * @param [start=0] Where the new `Buffer` will start.
+ * @param [end=buf.length] Where the new `Buffer` will end (not inclusive).
+ */
+ slice(start?: number, end?: number): Buffer;
+ /**
+ * Returns a new `Buffer` that references the same memory as the original, but
+ * offset and cropped by the `start` and `end` indices.
+ *
+ * Specifying `end` greater than `buf.length` will return the same result as
+ * that of `end` equal to `buf.length`.
+ *
+ * This method is inherited from [`TypedArray.prototype.subarray()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/subarray).
+ *
+ * Modifying the new `Buffer` slice will modify the memory in the original `Buffer`because the allocated memory of the two objects overlap.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * // Create a `Buffer` with the ASCII alphabet, take a slice, and modify one byte
+ * // from the original `Buffer`.
+ *
+ * const buf1 = Buffer.allocUnsafe(26);
+ *
+ * for (let i = 0; i < 26; i++) {
+ * // 97 is the decimal ASCII value for 'a'.
+ * buf1[i] = i + 97;
+ * }
+ *
+ * const buf2 = buf1.subarray(0, 3);
+ *
+ * console.log(buf2.toString('ascii', 0, buf2.length));
+ * // Prints: abc
+ *
+ * buf1[0] = 33;
+ *
+ * console.log(buf2.toString('ascii', 0, buf2.length));
+ * // Prints: !bc
+ * ```
+ *
+ * Specifying negative indexes causes the slice to be generated relative to the
+ * end of `buf` rather than the beginning.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from('buffer');
+ *
+ * console.log(buf.subarray(-6, -1).toString());
+ * // Prints: buffe
+ * // (Equivalent to buf.subarray(0, 5).)
+ *
+ * console.log(buf.subarray(-6, -2).toString());
+ * // Prints: buff
+ * // (Equivalent to buf.subarray(0, 4).)
+ *
+ * console.log(buf.subarray(-5, -2).toString());
+ * // Prints: uff
+ * // (Equivalent to buf.subarray(1, 4).)
+ * ```
+ * @since v3.0.0
+ * @param [start=0] Where the new `Buffer` will start.
+ * @param [end=buf.length] Where the new `Buffer` will end (not inclusive).
+ */
+ subarray(start?: number, end?: number): Buffer;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as big-endian.
+ *
+ * `value` is interpreted and written as a two's complement signed integer.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(8);
+ *
+ * buf.writeBigInt64BE(0x0102030405060708n, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v12.0.0, v10.20.0
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeBigInt64BE(value: bigint, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as little-endian.
+ *
+ * `value` is interpreted and written as a two's complement signed integer.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(8);
+ *
+ * buf.writeBigInt64LE(0x0102030405060708n, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v12.0.0, v10.20.0
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeBigInt64LE(value: bigint, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as big-endian.
+ *
+ * This function is also available under the `writeBigUint64BE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(8);
+ *
+ * buf.writeBigUInt64BE(0xdecafafecacefaden, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v12.0.0, v10.20.0
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeBigUInt64BE(value: bigint, offset?: number): number;
+ /**
+ * @alias Buffer.writeBigUInt64BE
+ * @since v14.10.0, v12.19.0
+ */
+ writeBigUint64BE(value: bigint, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as little-endian
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(8);
+ *
+ * buf.writeBigUInt64LE(0xdecafafecacefaden, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ *
+ * This function is also available under the `writeBigUint64LE` alias.
+ * @since v12.0.0, v10.20.0
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy: `0 <= offset <= buf.length - 8`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeBigUInt64LE(value: bigint, offset?: number): number;
+ /**
+ * @alias Buffer.writeBigUInt64LE
+ * @since v14.10.0, v12.19.0
+ */
+ writeBigUint64LE(value: bigint, offset?: number): number;
+ /**
+ * Writes `byteLength` bytes of `value` to `buf` at the specified `offset`as little-endian. Supports up to 48 bits of accuracy. Behavior is undefined
+ * when `value` is anything other than an unsigned integer.
+ *
+ * This function is also available under the `writeUintLE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(6);
+ *
+ * buf.writeUIntLE(0x1234567890ab, 0, 6);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.5.5
+ * @param value Number to be written to `buf`.
+ * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - byteLength`.
+ * @param byteLength Number of bytes to write. Must satisfy `0 < byteLength <= 6`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeUIntLE(value: number, offset: number, byteLength: number): number;
+ /**
+ * @alias Buffer.writeUIntLE
+ * @since v14.9.0, v12.19.0
+ */
+ writeUintLE(value: number, offset: number, byteLength: number): number;
+ /**
+ * Writes `byteLength` bytes of `value` to `buf` at the specified `offset`as big-endian. Supports up to 48 bits of accuracy. Behavior is undefined
+ * when `value` is anything other than an unsigned integer.
+ *
+ * This function is also available under the `writeUintBE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(6);
+ *
+ * buf.writeUIntBE(0x1234567890ab, 0, 6);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.5.5
+ * @param value Number to be written to `buf`.
+ * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - byteLength`.
+ * @param byteLength Number of bytes to write. Must satisfy `0 < byteLength <= 6`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeUIntBE(value: number, offset: number, byteLength: number): number;
+ /**
+ * @alias Buffer.writeUIntBE
+ * @since v14.9.0, v12.19.0
+ */
+ writeUintBE(value: number, offset: number, byteLength: number): number;
+ /**
+ * Writes `byteLength` bytes of `value` to `buf` at the specified `offset`as little-endian. Supports up to 48 bits of accuracy. Behavior is undefined
+ * when `value` is anything other than a signed integer.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(6);
+ *
+ * buf.writeIntLE(0x1234567890ab, 0, 6);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.11.15
+ * @param value Number to be written to `buf`.
+ * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - byteLength`.
+ * @param byteLength Number of bytes to write. Must satisfy `0 < byteLength <= 6`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeIntLE(value: number, offset: number, byteLength: number): number;
+ /**
+ * Writes `byteLength` bytes of `value` to `buf` at the specified `offset`as big-endian. Supports up to 48 bits of accuracy. Behavior is undefined when`value` is anything other than a
+ * signed integer.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(6);
+ *
+ * buf.writeIntBE(0x1234567890ab, 0, 6);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.11.15
+ * @param value Number to be written to `buf`.
+ * @param offset Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - byteLength`.
+ * @param byteLength Number of bytes to write. Must satisfy `0 < byteLength <= 6`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeIntBE(value: number, offset: number, byteLength: number): number;
+ /**
+ * Reads an unsigned, big-endian 64-bit integer from `buf` at the specified`offset`.
+ *
+ * This function is also available under the `readBigUint64BE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff]);
+ *
+ * console.log(buf.readBigUInt64BE(0));
+ * // Prints: 4294967295n
+ * ```
+ * @since v12.0.0, v10.20.0
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
+ */
+ readBigUInt64BE(offset?: number): bigint;
+ /**
+ * @alias Buffer.readBigUInt64BE
+ * @since v14.10.0, v12.19.0
+ */
+ readBigUint64BE(offset?: number): bigint;
+ /**
+ * Reads an unsigned, little-endian 64-bit integer from `buf` at the specified`offset`.
+ *
+ * This function is also available under the `readBigUint64LE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0x00, 0x00, 0x00, 0x00, 0xff, 0xff, 0xff, 0xff]);
+ *
+ * console.log(buf.readBigUInt64LE(0));
+ * // Prints: 18446744069414584320n
+ * ```
+ * @since v12.0.0, v10.20.0
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
+ */
+ readBigUInt64LE(offset?: number): bigint;
+ /**
+ * @alias Buffer.readBigUInt64LE
+ * @since v14.10.0, v12.19.0
+ */
+ readBigUint64LE(offset?: number): bigint;
+ /**
+ * Reads a signed, big-endian 64-bit integer from `buf` at the specified `offset`.
+ *
+ * Integers read from a `Buffer` are interpreted as two's complement signed
+ * values.
+ * @since v12.0.0, v10.20.0
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
+ */
+ readBigInt64BE(offset?: number): bigint;
+ /**
+ * Reads a signed, little-endian 64-bit integer from `buf` at the specified`offset`.
+ *
+ * Integers read from a `Buffer` are interpreted as two's complement signed
+ * values.
+ * @since v12.0.0, v10.20.0
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy: `0 <= offset <= buf.length - 8`.
+ */
+ readBigInt64LE(offset?: number): bigint;
+ /**
+ * Reads `byteLength` number of bytes from `buf` at the specified `offset`and interprets the result as an unsigned, little-endian integer supporting
+ * up to 48 bits of accuracy.
+ *
+ * This function is also available under the `readUintLE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
+ *
+ * console.log(buf.readUIntLE(0, 6).toString(16));
+ * // Prints: ab9078563412
+ * ```
+ * @since v0.11.15
+ * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - byteLength`.
+ * @param byteLength Number of bytes to read. Must satisfy `0 < byteLength <= 6`.
+ */
+ readUIntLE(offset: number, byteLength: number): number;
+ /**
+ * @alias Buffer.readUIntLE
+ * @since v14.9.0, v12.19.0
+ */
+ readUintLE(offset: number, byteLength: number): number;
+ /**
+ * Reads `byteLength` number of bytes from `buf` at the specified `offset`and interprets the result as an unsigned big-endian integer supporting
+ * up to 48 bits of accuracy.
+ *
+ * This function is also available under the `readUintBE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
+ *
+ * console.log(buf.readUIntBE(0, 6).toString(16));
+ * // Prints: 1234567890ab
+ * console.log(buf.readUIntBE(1, 6).toString(16));
+ * // Throws ERR_OUT_OF_RANGE.
+ * ```
+ * @since v0.11.15
+ * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - byteLength`.
+ * @param byteLength Number of bytes to read. Must satisfy `0 < byteLength <= 6`.
+ */
+ readUIntBE(offset: number, byteLength: number): number;
+ /**
+ * @alias Buffer.readUIntBE
+ * @since v14.9.0, v12.19.0
+ */
+ readUintBE(offset: number, byteLength: number): number;
+ /**
+ * Reads `byteLength` number of bytes from `buf` at the specified `offset`and interprets the result as a little-endian, two's complement signed value
+ * supporting up to 48 bits of accuracy.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
+ *
+ * console.log(buf.readIntLE(0, 6).toString(16));
+ * // Prints: -546f87a9cbee
+ * ```
+ * @since v0.11.15
+ * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - byteLength`.
+ * @param byteLength Number of bytes to read. Must satisfy `0 < byteLength <= 6`.
+ */
+ readIntLE(offset: number, byteLength: number): number;
+ /**
+ * Reads `byteLength` number of bytes from `buf` at the specified `offset`and interprets the result as a big-endian, two's complement signed value
+ * supporting up to 48 bits of accuracy.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78, 0x90, 0xab]);
+ *
+ * console.log(buf.readIntBE(0, 6).toString(16));
+ * // Prints: 1234567890ab
+ * console.log(buf.readIntBE(1, 6).toString(16));
+ * // Throws ERR_OUT_OF_RANGE.
+ * console.log(buf.readIntBE(1, 0).toString(16));
+ * // Throws ERR_OUT_OF_RANGE.
+ * ```
+ * @since v0.11.15
+ * @param offset Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - byteLength`.
+ * @param byteLength Number of bytes to read. Must satisfy `0 < byteLength <= 6`.
+ */
+ readIntBE(offset: number, byteLength: number): number;
+ /**
+ * Reads an unsigned 8-bit integer from `buf` at the specified `offset`.
+ *
+ * This function is also available under the `readUint8` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([1, -2]);
+ *
+ * console.log(buf.readUInt8(0));
+ * // Prints: 1
+ * console.log(buf.readUInt8(1));
+ * // Prints: 254
+ * console.log(buf.readUInt8(2));
+ * // Throws ERR_OUT_OF_RANGE.
+ * ```
+ * @since v0.5.0
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 1`.
+ */
+ readUInt8(offset?: number): number;
+ /**
+ * @alias Buffer.readUInt8
+ * @since v14.9.0, v12.19.0
+ */
+ readUint8(offset?: number): number;
+ /**
+ * Reads an unsigned, little-endian 16-bit integer from `buf` at the specified`offset`.
+ *
+ * This function is also available under the `readUint16LE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0x12, 0x34, 0x56]);
+ *
+ * console.log(buf.readUInt16LE(0).toString(16));
+ * // Prints: 3412
+ * console.log(buf.readUInt16LE(1).toString(16));
+ * // Prints: 5634
+ * console.log(buf.readUInt16LE(2).toString(16));
+ * // Throws ERR_OUT_OF_RANGE.
+ * ```
+ * @since v0.5.5
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
+ */
+ readUInt16LE(offset?: number): number;
+ /**
+ * @alias Buffer.readUInt16LE
+ * @since v14.9.0, v12.19.0
+ */
+ readUint16LE(offset?: number): number;
+ /**
+ * Reads an unsigned, big-endian 16-bit integer from `buf` at the specified`offset`.
+ *
+ * This function is also available under the `readUint16BE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0x12, 0x34, 0x56]);
+ *
+ * console.log(buf.readUInt16BE(0).toString(16));
+ * // Prints: 1234
+ * console.log(buf.readUInt16BE(1).toString(16));
+ * // Prints: 3456
+ * ```
+ * @since v0.5.5
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
+ */
+ readUInt16BE(offset?: number): number;
+ /**
+ * @alias Buffer.readUInt16BE
+ * @since v14.9.0, v12.19.0
+ */
+ readUint16BE(offset?: number): number;
+ /**
+ * Reads an unsigned, little-endian 32-bit integer from `buf` at the specified`offset`.
+ *
+ * This function is also available under the `readUint32LE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78]);
+ *
+ * console.log(buf.readUInt32LE(0).toString(16));
+ * // Prints: 78563412
+ * console.log(buf.readUInt32LE(1).toString(16));
+ * // Throws ERR_OUT_OF_RANGE.
+ * ```
+ * @since v0.5.5
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
+ */
+ readUInt32LE(offset?: number): number;
+ /**
+ * @alias Buffer.readUInt32LE
+ * @since v14.9.0, v12.19.0
+ */
+ readUint32LE(offset?: number): number;
+ /**
+ * Reads an unsigned, big-endian 32-bit integer from `buf` at the specified`offset`.
+ *
+ * This function is also available under the `readUint32BE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0x12, 0x34, 0x56, 0x78]);
+ *
+ * console.log(buf.readUInt32BE(0).toString(16));
+ * // Prints: 12345678
+ * ```
+ * @since v0.5.5
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
+ */
+ readUInt32BE(offset?: number): number;
+ /**
+ * @alias Buffer.readUInt32BE
+ * @since v14.9.0, v12.19.0
+ */
+ readUint32BE(offset?: number): number;
+ /**
+ * Reads a signed 8-bit integer from `buf` at the specified `offset`.
+ *
+ * Integers read from a `Buffer` are interpreted as two's complement signed values.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([-1, 5]);
+ *
+ * console.log(buf.readInt8(0));
+ * // Prints: -1
+ * console.log(buf.readInt8(1));
+ * // Prints: 5
+ * console.log(buf.readInt8(2));
+ * // Throws ERR_OUT_OF_RANGE.
+ * ```
+ * @since v0.5.0
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 1`.
+ */
+ readInt8(offset?: number): number;
+ /**
+ * Reads a signed, little-endian 16-bit integer from `buf` at the specified`offset`.
+ *
+ * Integers read from a `Buffer` are interpreted as two's complement signed values.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0, 5]);
+ *
+ * console.log(buf.readInt16LE(0));
+ * // Prints: 1280
+ * console.log(buf.readInt16LE(1));
+ * // Throws ERR_OUT_OF_RANGE.
+ * ```
+ * @since v0.5.5
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
+ */
+ readInt16LE(offset?: number): number;
+ /**
+ * Reads a signed, big-endian 16-bit integer from `buf` at the specified `offset`.
+ *
+ * Integers read from a `Buffer` are interpreted as two's complement signed values.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0, 5]);
+ *
+ * console.log(buf.readInt16BE(0));
+ * // Prints: 5
+ * ```
+ * @since v0.5.5
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 2`.
+ */
+ readInt16BE(offset?: number): number;
+ /**
+ * Reads a signed, little-endian 32-bit integer from `buf` at the specified`offset`.
+ *
+ * Integers read from a `Buffer` are interpreted as two's complement signed values.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0, 0, 0, 5]);
+ *
+ * console.log(buf.readInt32LE(0));
+ * // Prints: 83886080
+ * console.log(buf.readInt32LE(1));
+ * // Throws ERR_OUT_OF_RANGE.
+ * ```
+ * @since v0.5.5
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
+ */
+ readInt32LE(offset?: number): number;
+ /**
+ * Reads a signed, big-endian 32-bit integer from `buf` at the specified `offset`.
+ *
+ * Integers read from a `Buffer` are interpreted as two's complement signed values.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([0, 0, 0, 5]);
+ *
+ * console.log(buf.readInt32BE(0));
+ * // Prints: 5
+ * ```
+ * @since v0.5.5
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
+ */
+ readInt32BE(offset?: number): number;
+ /**
+ * Reads a 32-bit, little-endian float from `buf` at the specified `offset`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([1, 2, 3, 4]);
+ *
+ * console.log(buf.readFloatLE(0));
+ * // Prints: 1.539989614439558e-36
+ * console.log(buf.readFloatLE(1));
+ * // Throws ERR_OUT_OF_RANGE.
+ * ```
+ * @since v0.11.15
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
+ */
+ readFloatLE(offset?: number): number;
+ /**
+ * Reads a 32-bit, big-endian float from `buf` at the specified `offset`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([1, 2, 3, 4]);
+ *
+ * console.log(buf.readFloatBE(0));
+ * // Prints: 2.387939260590663e-38
+ * ```
+ * @since v0.11.15
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 4`.
+ */
+ readFloatBE(offset?: number): number;
+ /**
+ * Reads a 64-bit, little-endian double from `buf` at the specified `offset`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
+ *
+ * console.log(buf.readDoubleLE(0));
+ * // Prints: 5.447603722011605e-270
+ * console.log(buf.readDoubleLE(1));
+ * // Throws ERR_OUT_OF_RANGE.
+ * ```
+ * @since v0.11.15
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 8`.
+ */
+ readDoubleLE(offset?: number): number;
+ /**
+ * Reads a 64-bit, big-endian double from `buf` at the specified `offset`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from([1, 2, 3, 4, 5, 6, 7, 8]);
+ *
+ * console.log(buf.readDoubleBE(0));
+ * // Prints: 8.20788039913184e-304
+ * ```
+ * @since v0.11.15
+ * @param [offset=0] Number of bytes to skip before starting to read. Must satisfy `0 <= offset <= buf.length - 8`.
+ */
+ readDoubleBE(offset?: number): number;
+ reverse(): this;
+ /**
+ * Interprets `buf` as an array of unsigned 16-bit integers and swaps the
+ * byte order _in-place_. Throws `ERR_INVALID_BUFFER_SIZE` if `buf.length` is not a multiple of 2.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf1 = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
+ *
+ * console.log(buf1);
+ * // Prints:
+ *
+ * buf1.swap16();
+ *
+ * console.log(buf1);
+ * // Prints:
+ *
+ * const buf2 = Buffer.from([0x1, 0x2, 0x3]);
+ *
+ * buf2.swap16();
+ * // Throws ERR_INVALID_BUFFER_SIZE.
+ * ```
+ *
+ * One convenient use of `buf.swap16()` is to perform a fast in-place conversion
+ * between UTF-16 little-endian and UTF-16 big-endian:
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from('This is little-endian UTF-16', 'utf16le');
+ * buf.swap16(); // Convert to big-endian UTF-16 text.
+ * ```
+ * @since v5.10.0
+ * @return A reference to `buf`.
+ */
+ swap16(): Buffer;
+ /**
+ * Interprets `buf` as an array of unsigned 32-bit integers and swaps the
+ * byte order _in-place_. Throws `ERR_INVALID_BUFFER_SIZE` if `buf.length` is not a multiple of 4.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf1 = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
+ *
+ * console.log(buf1);
+ * // Prints:
+ *
+ * buf1.swap32();
+ *
+ * console.log(buf1);
+ * // Prints:
+ *
+ * const buf2 = Buffer.from([0x1, 0x2, 0x3]);
+ *
+ * buf2.swap32();
+ * // Throws ERR_INVALID_BUFFER_SIZE.
+ * ```
+ * @since v5.10.0
+ * @return A reference to `buf`.
+ */
+ swap32(): Buffer;
+ /**
+ * Interprets `buf` as an array of 64-bit numbers and swaps byte order _in-place_.
+ * Throws `ERR_INVALID_BUFFER_SIZE` if `buf.length` is not a multiple of 8.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf1 = Buffer.from([0x1, 0x2, 0x3, 0x4, 0x5, 0x6, 0x7, 0x8]);
+ *
+ * console.log(buf1);
+ * // Prints:
+ *
+ * buf1.swap64();
+ *
+ * console.log(buf1);
+ * // Prints:
+ *
+ * const buf2 = Buffer.from([0x1, 0x2, 0x3]);
+ *
+ * buf2.swap64();
+ * // Throws ERR_INVALID_BUFFER_SIZE.
+ * ```
+ * @since v6.3.0
+ * @return A reference to `buf`.
+ */
+ swap64(): Buffer;
+ /**
+ * Writes `value` to `buf` at the specified `offset`. `value` must be a
+ * valid unsigned 8-bit integer. Behavior is undefined when `value` is anything
+ * other than an unsigned 8-bit integer.
+ *
+ * This function is also available under the `writeUint8` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(4);
+ *
+ * buf.writeUInt8(0x3, 0);
+ * buf.writeUInt8(0x4, 1);
+ * buf.writeUInt8(0x23, 2);
+ * buf.writeUInt8(0x42, 3);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.5.0
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 1`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeUInt8(value: number, offset?: number): number;
+ /**
+ * @alias Buffer.writeUInt8
+ * @since v14.9.0, v12.19.0
+ */
+ writeUint8(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as little-endian. The `value`must be a valid unsigned 16-bit integer. Behavior is undefined when `value` is
+ * anything other than an unsigned 16-bit integer.
+ *
+ * This function is also available under the `writeUint16LE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(4);
+ *
+ * buf.writeUInt16LE(0xdead, 0);
+ * buf.writeUInt16LE(0xbeef, 2);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.5.5
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeUInt16LE(value: number, offset?: number): number;
+ /**
+ * @alias Buffer.writeUInt16LE
+ * @since v14.9.0, v12.19.0
+ */
+ writeUint16LE(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as big-endian. The `value`must be a valid unsigned 16-bit integer. Behavior is undefined when `value`is anything other than an
+ * unsigned 16-bit integer.
+ *
+ * This function is also available under the `writeUint16BE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(4);
+ *
+ * buf.writeUInt16BE(0xdead, 0);
+ * buf.writeUInt16BE(0xbeef, 2);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.5.5
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeUInt16BE(value: number, offset?: number): number;
+ /**
+ * @alias Buffer.writeUInt16BE
+ * @since v14.9.0, v12.19.0
+ */
+ writeUint16BE(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as little-endian. The `value`must be a valid unsigned 32-bit integer. Behavior is undefined when `value` is
+ * anything other than an unsigned 32-bit integer.
+ *
+ * This function is also available under the `writeUint32LE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(4);
+ *
+ * buf.writeUInt32LE(0xfeedface, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.5.5
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeUInt32LE(value: number, offset?: number): number;
+ /**
+ * @alias Buffer.writeUInt32LE
+ * @since v14.9.0, v12.19.0
+ */
+ writeUint32LE(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as big-endian. The `value`must be a valid unsigned 32-bit integer. Behavior is undefined when `value`is anything other than an
+ * unsigned 32-bit integer.
+ *
+ * This function is also available under the `writeUint32BE` alias.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(4);
+ *
+ * buf.writeUInt32BE(0xfeedface, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.5.5
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeUInt32BE(value: number, offset?: number): number;
+ /**
+ * @alias Buffer.writeUInt32BE
+ * @since v14.9.0, v12.19.0
+ */
+ writeUint32BE(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset`. `value` must be a valid
+ * signed 8-bit integer. Behavior is undefined when `value` is anything other than
+ * a signed 8-bit integer.
+ *
+ * `value` is interpreted and written as a two's complement signed integer.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(2);
+ *
+ * buf.writeInt8(2, 0);
+ * buf.writeInt8(-2, 1);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.5.0
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 1`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeInt8(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as little-endian. The `value`must be a valid signed 16-bit integer. Behavior is undefined when `value` is
+ * anything other than a signed 16-bit integer.
+ *
+ * The `value` is interpreted and written as a two's complement signed integer.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(2);
+ *
+ * buf.writeInt16LE(0x0304, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.5.5
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeInt16LE(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as big-endian. The `value`must be a valid signed 16-bit integer. Behavior is undefined when `value` is
+ * anything other than a signed 16-bit integer.
+ *
+ * The `value` is interpreted and written as a two's complement signed integer.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(2);
+ *
+ * buf.writeInt16BE(0x0102, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.5.5
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 2`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeInt16BE(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as little-endian. The `value`must be a valid signed 32-bit integer. Behavior is undefined when `value` is
+ * anything other than a signed 32-bit integer.
+ *
+ * The `value` is interpreted and written as a two's complement signed integer.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(4);
+ *
+ * buf.writeInt32LE(0x05060708, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.5.5
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeInt32LE(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as big-endian. The `value`must be a valid signed 32-bit integer. Behavior is undefined when `value` is
+ * anything other than a signed 32-bit integer.
+ *
+ * The `value` is interpreted and written as a two's complement signed integer.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(4);
+ *
+ * buf.writeInt32BE(0x01020304, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.5.5
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeInt32BE(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as little-endian. Behavior is
+ * undefined when `value` is anything other than a JavaScript number.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(4);
+ *
+ * buf.writeFloatLE(0xcafebabe, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.11.15
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeFloatLE(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as big-endian. Behavior is
+ * undefined when `value` is anything other than a JavaScript number.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(4);
+ *
+ * buf.writeFloatBE(0xcafebabe, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.11.15
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 4`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeFloatBE(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as little-endian. The `value`must be a JavaScript number. Behavior is undefined when `value` is anything
+ * other than a JavaScript number.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(8);
+ *
+ * buf.writeDoubleLE(123.456, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.11.15
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 8`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeDoubleLE(value: number, offset?: number): number;
+ /**
+ * Writes `value` to `buf` at the specified `offset` as big-endian. The `value`must be a JavaScript number. Behavior is undefined when `value` is anything
+ * other than a JavaScript number.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(8);
+ *
+ * buf.writeDoubleBE(123.456, 0);
+ *
+ * console.log(buf);
+ * // Prints:
+ * ```
+ * @since v0.11.15
+ * @param value Number to be written to `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to write. Must satisfy `0 <= offset <= buf.length - 8`.
+ * @return `offset` plus the number of bytes written.
+ */
+ writeDoubleBE(value: number, offset?: number): number;
+ /**
+ * Fills `buf` with the specified `value`. If the `offset` and `end` are not given,
+ * the entire `buf` will be filled:
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * // Fill a `Buffer` with the ASCII character 'h'.
+ *
+ * const b = Buffer.allocUnsafe(50).fill('h');
+ *
+ * console.log(b.toString());
+ * // Prints: hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh
+ * ```
+ *
+ * `value` is coerced to a `uint32` value if it is not a string, `Buffer`, or
+ * integer. If the resulting integer is greater than `255` (decimal), `buf` will be
+ * filled with `value & 255`.
+ *
+ * If the final write of a `fill()` operation falls on a multi-byte character,
+ * then only the bytes of that character that fit into `buf` are written:
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * // Fill a `Buffer` with character that takes up two bytes in UTF-8.
+ *
+ * console.log(Buffer.allocUnsafe(5).fill('\u0222'));
+ * // Prints:
+ * ```
+ *
+ * If `value` contains invalid characters, it is truncated; if no valid
+ * fill data remains, an exception is thrown:
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.allocUnsafe(5);
+ *
+ * console.log(buf.fill('a'));
+ * // Prints:
+ * console.log(buf.fill('aazz', 'hex'));
+ * // Prints:
+ * console.log(buf.fill('zz', 'hex'));
+ * // Throws an exception.
+ * ```
+ * @since v0.5.0
+ * @param value The value with which to fill `buf`.
+ * @param [offset=0] Number of bytes to skip before starting to fill `buf`.
+ * @param [end=buf.length] Where to stop filling `buf` (not inclusive).
+ * @param [encoding='utf8'] The encoding for `value` if `value` is a string.
+ * @return A reference to `buf`.
+ */
+ fill(value: string | Uint8Array | number, offset?: number, end?: number, encoding?: BufferEncoding): this;
+ /**
+ * If `value` is:
+ *
+ * * a string, `value` is interpreted according to the character encoding in`encoding`.
+ * * a `Buffer` or [`Uint8Array`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Uint8Array), `value` will be used in its entirety.
+ * To compare a partial `Buffer`, use `buf.slice()`.
+ * * a number, `value` will be interpreted as an unsigned 8-bit integer
+ * value between `0` and `255`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from('this is a buffer');
+ *
+ * console.log(buf.indexOf('this'));
+ * // Prints: 0
+ * console.log(buf.indexOf('is'));
+ * // Prints: 2
+ * console.log(buf.indexOf(Buffer.from('a buffer')));
+ * // Prints: 8
+ * console.log(buf.indexOf(97));
+ * // Prints: 8 (97 is the decimal ASCII value for 'a')
+ * console.log(buf.indexOf(Buffer.from('a buffer example')));
+ * // Prints: -1
+ * console.log(buf.indexOf(Buffer.from('a buffer example').slice(0, 8)));
+ * // Prints: 8
+ *
+ * const utf16Buffer = Buffer.from('\u039a\u0391\u03a3\u03a3\u0395', 'utf16le');
+ *
+ * console.log(utf16Buffer.indexOf('\u03a3', 0, 'utf16le'));
+ * // Prints: 4
+ * console.log(utf16Buffer.indexOf('\u03a3', -4, 'utf16le'));
+ * // Prints: 6
+ * ```
+ *
+ * If `value` is not a string, number, or `Buffer`, this method will throw a`TypeError`. If `value` is a number, it will be coerced to a valid byte value,
+ * an integer between 0 and 255.
+ *
+ * If `byteOffset` is not a number, it will be coerced to a number. If the result
+ * of coercion is `NaN` or `0`, then the entire buffer will be searched. This
+ * behavior matches [`String.prototype.indexOf()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/indexOf).
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const b = Buffer.from('abcdef');
+ *
+ * // Passing a value that's a number, but not a valid byte.
+ * // Prints: 2, equivalent to searching for 99 or 'c'.
+ * console.log(b.indexOf(99.9));
+ * console.log(b.indexOf(256 + 99));
+ *
+ * // Passing a byteOffset that coerces to NaN or 0.
+ * // Prints: 1, searching the whole buffer.
+ * console.log(b.indexOf('b', undefined));
+ * console.log(b.indexOf('b', {}));
+ * console.log(b.indexOf('b', null));
+ * console.log(b.indexOf('b', []));
+ * ```
+ *
+ * If `value` is an empty string or empty `Buffer` and `byteOffset` is less
+ * than `buf.length`, `byteOffset` will be returned. If `value` is empty and`byteOffset` is at least `buf.length`, `buf.length` will be returned.
+ * @since v1.5.0
+ * @param value What to search for.
+ * @param [byteOffset=0] Where to begin searching in `buf`. If negative, then offset is calculated from the end of `buf`.
+ * @param [encoding='utf8'] If `value` is a string, this is the encoding used to determine the binary representation of the string that will be searched for in `buf`.
+ * @return The index of the first occurrence of `value` in `buf`, or `-1` if `buf` does not contain `value`.
+ */
+ indexOf(value: string | number | Uint8Array, byteOffset?: number, encoding?: BufferEncoding): number;
+ /**
+ * Identical to `buf.indexOf()`, except the last occurrence of `value` is found
+ * rather than the first occurrence.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from('this buffer is a buffer');
+ *
+ * console.log(buf.lastIndexOf('this'));
+ * // Prints: 0
+ * console.log(buf.lastIndexOf('buffer'));
+ * // Prints: 17
+ * console.log(buf.lastIndexOf(Buffer.from('buffer')));
+ * // Prints: 17
+ * console.log(buf.lastIndexOf(97));
+ * // Prints: 15 (97 is the decimal ASCII value for 'a')
+ * console.log(buf.lastIndexOf(Buffer.from('yolo')));
+ * // Prints: -1
+ * console.log(buf.lastIndexOf('buffer', 5));
+ * // Prints: 5
+ * console.log(buf.lastIndexOf('buffer', 4));
+ * // Prints: -1
+ *
+ * const utf16Buffer = Buffer.from('\u039a\u0391\u03a3\u03a3\u0395', 'utf16le');
+ *
+ * console.log(utf16Buffer.lastIndexOf('\u03a3', undefined, 'utf16le'));
+ * // Prints: 6
+ * console.log(utf16Buffer.lastIndexOf('\u03a3', -5, 'utf16le'));
+ * // Prints: 4
+ * ```
+ *
+ * If `value` is not a string, number, or `Buffer`, this method will throw a`TypeError`. If `value` is a number, it will be coerced to a valid byte value,
+ * an integer between 0 and 255.
+ *
+ * If `byteOffset` is not a number, it will be coerced to a number. Any arguments
+ * that coerce to `NaN`, like `{}` or `undefined`, will search the whole buffer.
+ * This behavior matches [`String.prototype.lastIndexOf()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/lastIndexOf).
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const b = Buffer.from('abcdef');
+ *
+ * // Passing a value that's a number, but not a valid byte.
+ * // Prints: 2, equivalent to searching for 99 or 'c'.
+ * console.log(b.lastIndexOf(99.9));
+ * console.log(b.lastIndexOf(256 + 99));
+ *
+ * // Passing a byteOffset that coerces to NaN.
+ * // Prints: 1, searching the whole buffer.
+ * console.log(b.lastIndexOf('b', undefined));
+ * console.log(b.lastIndexOf('b', {}));
+ *
+ * // Passing a byteOffset that coerces to 0.
+ * // Prints: -1, equivalent to passing 0.
+ * console.log(b.lastIndexOf('b', null));
+ * console.log(b.lastIndexOf('b', []));
+ * ```
+ *
+ * If `value` is an empty string or empty `Buffer`, `byteOffset` will be returned.
+ * @since v6.0.0
+ * @param value What to search for.
+ * @param [byteOffset=buf.length - 1] Where to begin searching in `buf`. If negative, then offset is calculated from the end of `buf`.
+ * @param [encoding='utf8'] If `value` is a string, this is the encoding used to determine the binary representation of the string that will be searched for in `buf`.
+ * @return The index of the last occurrence of `value` in `buf`, or `-1` if `buf` does not contain `value`.
+ */
+ lastIndexOf(value: string | number | Uint8Array, byteOffset?: number, encoding?: BufferEncoding): number;
+ /**
+ * Creates and returns an [iterator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols) of `[index, byte]` pairs from the contents
+ * of `buf`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * // Log the entire contents of a `Buffer`.
+ *
+ * const buf = Buffer.from('buffer');
+ *
+ * for (const pair of buf.entries()) {
+ * console.log(pair);
+ * }
+ * // Prints:
+ * // [0, 98]
+ * // [1, 117]
+ * // [2, 102]
+ * // [3, 102]
+ * // [4, 101]
+ * // [5, 114]
+ * ```
+ * @since v1.1.0
+ */
+ entries(): IterableIterator<[number, number]>;
+ /**
+ * Equivalent to `buf.indexOf() !== -1`.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from('this is a buffer');
+ *
+ * console.log(buf.includes('this'));
+ * // Prints: true
+ * console.log(buf.includes('is'));
+ * // Prints: true
+ * console.log(buf.includes(Buffer.from('a buffer')));
+ * // Prints: true
+ * console.log(buf.includes(97));
+ * // Prints: true (97 is the decimal ASCII value for 'a')
+ * console.log(buf.includes(Buffer.from('a buffer example')));
+ * // Prints: false
+ * console.log(buf.includes(Buffer.from('a buffer example').slice(0, 8)));
+ * // Prints: true
+ * console.log(buf.includes('this', 4));
+ * // Prints: false
+ * ```
+ * @since v5.3.0
+ * @param value What to search for.
+ * @param [byteOffset=0] Where to begin searching in `buf`. If negative, then offset is calculated from the end of `buf`.
+ * @param [encoding='utf8'] If `value` is a string, this is its encoding.
+ * @return `true` if `value` was found in `buf`, `false` otherwise.
+ */
+ includes(value: string | number | Buffer, byteOffset?: number, encoding?: BufferEncoding): boolean;
+ /**
+ * Creates and returns an [iterator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols) of `buf` keys (indices).
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from('buffer');
+ *
+ * for (const key of buf.keys()) {
+ * console.log(key);
+ * }
+ * // Prints:
+ * // 0
+ * // 1
+ * // 2
+ * // 3
+ * // 4
+ * // 5
+ * ```
+ * @since v1.1.0
+ */
+ keys(): IterableIterator;
+ /**
+ * Creates and returns an [iterator](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols) for `buf` values (bytes). This function is
+ * called automatically when a `Buffer` is used in a `for..of` statement.
+ *
+ * ```js
+ * import { Buffer } from 'buffer';
+ *
+ * const buf = Buffer.from('buffer');
+ *
+ * for (const value of buf.values()) {
+ * console.log(value);
+ * }
+ * // Prints:
+ * // 98
+ * // 117
+ * // 102
+ * // 102
+ * // 101
+ * // 114
+ *
+ * for (const value of buf) {
+ * console.log(value);
+ * }
+ * // Prints:
+ * // 98
+ * // 117
+ * // 102
+ * // 102
+ * // 101
+ * // 114
+ * ```
+ * @since v1.1.0
+ */
+ values(): IterableIterator;
+ }
+ var Buffer: BufferConstructor;
+ /**
+ * Decodes a string of Base64-encoded data into bytes, and encodes those bytes
+ * into a string using Latin-1 (ISO-8859-1).
+ *
+ * The `data` may be any JavaScript-value that can be coerced into a string.
+ *
+ * **This function is only provided for compatibility with legacy web platform APIs**
+ * **and should never be used in new code, because they use strings to represent**
+ * **binary data and predate the introduction of typed arrays in JavaScript.**
+ * **For code running using Node.js APIs, converting between base64-encoded strings**
+ * **and binary data should be performed using `Buffer.from(str, 'base64')` and`buf.toString('base64')`.**
+ * @since v15.13.0
+ * @deprecated Use `Buffer.from(data, 'base64')` instead.
+ * @param data The Base64-encoded input string.
+ */
+ function atob(data: string): string;
+ /**
+ * Decodes a string into bytes using Latin-1 (ISO-8859), and encodes those bytes
+ * into a string using Base64.
+ *
+ * The `data` may be any JavaScript-value that can be coerced into a string.
+ *
+ * **This function is only provided for compatibility with legacy web platform APIs**
+ * **and should never be used in new code, because they use strings to represent**
+ * **binary data and predate the introduction of typed arrays in JavaScript.**
+ * **For code running using Node.js APIs, converting between base64-encoded strings**
+ * **and binary data should be performed using `Buffer.from(str, 'base64')` and`buf.toString('base64')`.**
+ * @since v15.13.0
+ * @deprecated Use `buf.toString('base64')` instead.
+ * @param data An ASCII (Latin1) string.
+ */
+ function btoa(data: string): string;
}
-
- export { BuffType as Buffer };
}
declare module 'node:buffer' {
export * from 'buffer';
diff --git a/packages/node_modules/@node-red/editor-client/src/types/node/child_process.d.ts b/packages/node_modules/@node-red/editor-client/src/types/node/child_process.d.ts
index a56583b28..d79c74a3b 100644
--- a/packages/node_modules/@node-red/editor-client/src/types/node/child_process.d.ts
+++ b/packages/node_modules/@node-red/editor-client/src/types/node/child_process.d.ts
@@ -1,42 +1,518 @@
/* NOTE: Do not edit directly! This file is generated using `npm run update-types` in https://github.com/Steve-Mcl/monaco-editor-esm-i18n */
+/**
+ * The `child_process` module provides the ability to spawn subprocesses in
+ * a manner that is similar, but not identical, to [`popen(3)`](http://man7.org/linux/man-pages/man3/popen.3.html). This capability
+ * is primarily provided by the {@link spawn} function:
+ *
+ * ```js
+ * const { spawn } = require('child_process');
+ * const ls = spawn('ls', ['-lh', '/usr']);
+ *
+ * ls.stdout.on('data', (data) => {
+ * console.log(`stdout: ${data}`);
+ * });
+ *
+ * ls.stderr.on('data', (data) => {
+ * console.error(`stderr: ${data}`);
+ * });
+ *
+ * ls.on('close', (code) => {
+ * console.log(`child process exited with code ${code}`);
+ * });
+ * ```
+ *
+ * By default, pipes for `stdin`, `stdout`, and `stderr` are established between
+ * the parent Node.js process and the spawned subprocess. These pipes have
+ * limited (and platform-specific) capacity. If the subprocess writes to
+ * stdout in excess of that limit without the output being captured, the
+ * subprocess blocks waiting for the pipe buffer to accept more data. This is
+ * identical to the behavior of pipes in the shell. Use the `{ stdio: 'ignore' }`option if the output will not be consumed.
+ *
+ * The command lookup is performed using the `options.env.PATH` environment
+ * variable if it is in the `options` object. Otherwise, `process.env.PATH` is
+ * used.
+ *
+ * On Windows, environment variables are case-insensitive. Node.js
+ * lexicographically sorts the `env` keys and uses the first one that
+ * case-insensitively matches. Only first (in lexicographic order) entry will be
+ * passed to the subprocess. This might lead to issues on Windows when passing
+ * objects to the `env` option that have multiple variants of the same key, such as`PATH` and `Path`.
+ *
+ * The {@link spawn} method spawns the child process asynchronously,
+ * without blocking the Node.js event loop. The {@link spawnSync} function provides equivalent functionality in a synchronous manner that blocks
+ * the event loop until the spawned process either exits or is terminated.
+ *
+ * For convenience, the `child_process` module provides a handful of synchronous
+ * and asynchronous alternatives to {@link spawn} and {@link spawnSync}. Each of these alternatives are implemented on
+ * top of {@link spawn} or {@link spawnSync}.
+ *
+ * * {@link exec}: spawns a shell and runs a command within that
+ * shell, passing the `stdout` and `stderr` to a callback function when
+ * complete.
+ * * {@link execFile}: similar to {@link exec} except
+ * that it spawns the command directly without first spawning a shell by
+ * default.
+ * * {@link fork}: spawns a new Node.js process and invokes a
+ * specified module with an IPC communication channel established that allows
+ * sending messages between parent and child.
+ * * {@link execSync}: a synchronous version of {@link exec} that will block the Node.js event loop.
+ * * {@link execFileSync}: a synchronous version of {@link execFile} that will block the Node.js event loop.
+ *
+ * For certain use cases, such as automating shell scripts, the `synchronous counterparts` may be more convenient. In many cases, however,
+ * the synchronous methods can have significant impact on performance due to
+ * stalling the event loop while spawned processes complete.
+ * @see [source](https://github.com/nodejs/node/blob/v16.9.0/lib/child_process.js)
+ */
declare module 'child_process' {
- import { BaseEncodingOptions } from 'fs';
- import * as events from 'events';
- import * as net from 'net';
- import { Writable, Readable, Stream, Pipe } from 'stream';
-
- type Serializable = string | object | number | boolean;
+ import { ObjectEncodingOptions } from 'node:fs';
+ import { EventEmitter, Abortable } from 'node:events';
+ import * as net from 'node:net';
+ import { Writable, Readable, Stream, Pipe } from 'node:stream';
+ import { URL } from 'node:url';
+ type Serializable = string | object | number | boolean | bigint;
type SendHandle = net.Socket | net.Server;
-
- interface ChildProcess extends events.EventEmitter {
+ /**
+ * Instances of the `ChildProcess` represent spawned child processes.
+ *
+ * Instances of `ChildProcess` are not intended to be created directly. Rather,
+ * use the {@link spawn}, {@link exec},{@link execFile}, or {@link fork} methods to create
+ * instances of `ChildProcess`.
+ * @since v2.2.0
+ */
+ class ChildProcess extends EventEmitter {
+ /**
+ * A `Writable Stream` that represents the child process's `stdin`.
+ *
+ * If a child process waits to read all of its input, the child will not continue
+ * until this stream has been closed via `end()`.
+ *
+ * If the child was spawned with `stdio[0]` set to anything other than `'pipe'`,
+ * then this will be `null`.
+ *
+ * `subprocess.stdin` is an alias for `subprocess.stdio[0]`. Both properties will
+ * refer to the same value.
+ *
+ * The `subprocess.stdin` property can be `undefined` if the child process could
+ * not be successfully spawned.
+ * @since v0.1.90
+ */
stdin: Writable | null;
+ /**
+ * A `Readable Stream` that represents the child process's `stdout`.
+ *
+ * If the child was spawned with `stdio[1]` set to anything other than `'pipe'`,
+ * then this will be `null`.
+ *
+ * `subprocess.stdout` is an alias for `subprocess.stdio[1]`. Both properties will
+ * refer to the same value.
+ *
+ * ```js
+ * const { spawn } = require('child_process');
+ *
+ * const subprocess = spawn('ls');
+ *
+ * subprocess.stdout.on('data', (data) => {
+ * console.log(`Received chunk ${data}`);
+ * });
+ * ```
+ *
+ * The `subprocess.stdout` property can be `null` if the child process could
+ * not be successfully spawned.
+ * @since v0.1.90
+ */
stdout: Readable | null;
+ /**
+ * A `Readable Stream` that represents the child process's `stderr`.
+ *
+ * If the child was spawned with `stdio[2]` set to anything other than `'pipe'`,
+ * then this will be `null`.
+ *
+ * `subprocess.stderr` is an alias for `subprocess.stdio[2]`. Both properties will
+ * refer to the same value.
+ *
+ * The `subprocess.stderr` property can be `null` if the child process could
+ * not be successfully spawned.
+ * @since v0.1.90
+ */
stderr: Readable | null;
+ /**
+ * The `subprocess.channel` property is a reference to the child's IPC channel. If
+ * no IPC channel currently exists, this property is `undefined`.
+ * @since v7.1.0
+ */
readonly channel?: Pipe | null | undefined;
+ /**
+ * A sparse array of pipes to the child process, corresponding with positions in
+ * the `stdio` option passed to {@link spawn} that have been set
+ * to the value `'pipe'`. `subprocess.stdio[0]`, `subprocess.stdio[1]`, and`subprocess.stdio[2]` are also available as `subprocess.stdin`,`subprocess.stdout`, and `subprocess.stderr`,
+ * respectively.
+ *
+ * In the following example, only the child's fd `1` (stdout) is configured as a
+ * pipe, so only the parent's `subprocess.stdio[1]` is a stream, all other values
+ * in the array are `null`.
+ *
+ * ```js
+ * const assert = require('assert');
+ * const fs = require('fs');
+ * const child_process = require('child_process');
+ *
+ * const subprocess = child_process.spawn('ls', {
+ * stdio: [
+ * 0, // Use parent's stdin for child.
+ * 'pipe', // Pipe child's stdout to parent.
+ * fs.openSync('err.out', 'w'), // Direct child's stderr to a file.
+ * ]
+ * });
+ *
+ * assert.strictEqual(subprocess.stdio[0], null);
+ * assert.strictEqual(subprocess.stdio[0], subprocess.stdin);
+ *
+ * assert(subprocess.stdout);
+ * assert.strictEqual(subprocess.stdio[1], subprocess.stdout);
+ *
+ * assert.strictEqual(subprocess.stdio[2], null);
+ * assert.strictEqual(subprocess.stdio[2], subprocess.stderr);
+ * ```
+ *
+ * The `subprocess.stdio` property can be `undefined` if the child process could
+ * not be successfully spawned.
+ * @since v0.7.10
+ */
readonly stdio: [
- Writable | null, // stdin
- Readable | null, // stdout
- Readable | null, // stderr
- Readable | Writable | null | undefined, // extra
+ Writable | null,
+ // stdin
+ Readable | null,
+ // stdout
+ Readable | null,
+ // stderr
+ Readable | Writable | null | undefined,
+ // extra
Readable | Writable | null | undefined // extra
];
+ /**
+ * The `subprocess.killed` property indicates whether the child process
+ * successfully received a signal from `subprocess.kill()`. The `killed` property
+ * does not indicate that the child process has been terminated.
+ * @since v0.5.10
+ */
readonly killed: boolean;
- readonly pid: number;
+ /**
+ * Returns the process identifier (PID) of the child process. If the child process
+ * fails to spawn due to errors, then the value is `undefined` and `error` is
+ * emitted.
+ *
+ * ```js
+ * const { spawn } = require('child_process');
+ * const grep = spawn('grep', ['ssh']);
+ *
+ * console.log(`Spawned child pid: ${grep.pid}`);
+ * grep.stdin.end();
+ * ```
+ * @since v0.1.90
+ */
+ readonly pid?: number | undefined;
+ /**
+ * The `subprocess.connected` property indicates whether it is still possible to
+ * send and receive messages from a child process. When `subprocess.connected` is`false`, it is no longer possible to send or receive messages.
+ * @since v0.7.2
+ */
readonly connected: boolean;
+ /**
+ * The `subprocess.exitCode` property indicates the exit code of the child process.
+ * If the child process is still running, the field will be `null`.
+ */
readonly exitCode: number | null;
+ /**
+ * The `subprocess.signalCode` property indicates the signal received by
+ * the child process if any, else `null`.
+ */
readonly signalCode: NodeJS.Signals | null;
+ /**
+ * The `subprocess.spawnargs` property represents the full list of command-line
+ * arguments the child process was launched with.
+ */
readonly spawnargs: string[];
+ /**
+ * The `subprocess.spawnfile` property indicates the executable file name of
+ * the child process that is launched.
+ *
+ * For {@link fork}, its value will be equal to `process.execPath`.
+ * For {@link spawn}, its value will be the name of
+ * the executable file.
+ * For {@link exec}, its value will be the name of the shell
+ * in which the child process is launched.
+ */
readonly spawnfile: string;
+ /**
+ * The `subprocess.kill()` method sends a signal to the child process. If no
+ * argument is given, the process will be sent the `'SIGTERM'` signal. See [`signal(7)`](http://man7.org/linux/man-pages/man7/signal.7.html) for a list of available signals. This function
+ * returns `true` if [`kill(2)`](http://man7.org/linux/man-pages/man2/kill.2.html) succeeds, and `false` otherwise.
+ *
+ * ```js
+ * const { spawn } = require('child_process');
+ * const grep = spawn('grep', ['ssh']);
+ *
+ * grep.on('close', (code, signal) => {
+ * console.log(
+ * `child process terminated due to receipt of signal ${signal}`);
+ * });
+ *
+ * // Send SIGHUP to process.
+ * grep.kill('SIGHUP');
+ * ```
+ *
+ * The `ChildProcess` object may emit an `'error'` event if the signal
+ * cannot be delivered. Sending a signal to a child process that has already exited
+ * is not an error but may have unforeseen consequences. Specifically, if the
+ * process identifier (PID) has been reassigned to another process, the signal will
+ * be delivered to that process instead which can have unexpected results.
+ *
+ * While the function is called `kill`, the signal delivered to the child process
+ * may not actually terminate the process.
+ *
+ * See [`kill(2)`](http://man7.org/linux/man-pages/man2/kill.2.html) for reference.
+ *
+ * On Windows, where POSIX signals do not exist, the `signal` argument will be
+ * ignored, and the process will be killed forcefully and abruptly (similar to`'SIGKILL'`).
+ * See `Signal Events` for more details.
+ *
+ * On Linux, child processes of child processes will not be terminated
+ * when attempting to kill their parent. This is likely to happen when running a
+ * new process in a shell or with the use of the `shell` option of `ChildProcess`:
+ *
+ * ```js
+ * 'use strict';
+ * const { spawn } = require('child_process');
+ *
+ * const subprocess = spawn(
+ * 'sh',
+ * [
+ * '-c',
+ * `node -e "setInterval(() => {
+ * console.log(process.pid, 'is alive')
+ * }, 500);"`,
+ * ], {
+ * stdio: ['inherit', 'inherit', 'inherit']
+ * }
+ * );
+ *
+ * setTimeout(() => {
+ * subprocess.kill(); // Does not terminate the Node.js process in the shell.
+ * }, 2000);
+ * ```
+ * @since v0.1.90
+ */
kill(signal?: NodeJS.Signals | number): boolean;
+ /**
+ * When an IPC channel has been established between the parent and child (
+ * i.e. when using {@link fork}), the `subprocess.send()` method can
+ * be used to send messages to the child process. When the child process is a
+ * Node.js instance, these messages can be received via the `'message'` event.
+ *
+ * The message goes through serialization and parsing. The resulting
+ * message might not be the same as what is originally sent.
+ *
+ * For example, in the parent script:
+ *
+ * ```js
+ * const cp = require('child_process');
+ * const n = cp.fork(`${__dirname}/sub.js`);
+ *
+ * n.on('message', (m) => {
+ * console.log('PARENT got message:', m);
+ * });
+ *
+ * // Causes the child to print: CHILD got message: { hello: 'world' }
+ * n.send({ hello: 'world' });
+ * ```
+ *
+ * And then the child script, `'sub.js'` might look like this:
+ *
+ * ```js
+ * process.on('message', (m) => {
+ * console.log('CHILD got message:', m);
+ * });
+ *
+ * // Causes the parent to print: PARENT got message: { foo: 'bar', baz: null }
+ * process.send({ foo: 'bar', baz: NaN });
+ * ```
+ *
+ * Child Node.js processes will have a `process.send()` method of their own
+ * that allows the child to send messages back to the parent.
+ *
+ * There is a special case when sending a `{cmd: 'NODE_foo'}` message. Messages
+ * containing a `NODE_` prefix in the `cmd` property are reserved for use within
+ * Node.js core and will not be emitted in the child's `'message'` event. Rather, such messages are emitted using the`'internalMessage'` event and are consumed internally by Node.js.
+ * Applications should avoid using such messages or listening for`'internalMessage'` events as it is subject to change without notice.
+ *
+ * The optional `sendHandle` argument that may be passed to `subprocess.send()` is
+ * for passing a TCP server or socket object to the child process. The child will
+ * receive the object as the second argument passed to the callback function
+ * registered on the `'message'` event. Any data that is received
+ * and buffered in the socket will not be sent to the child.
+ *
+ * The optional `callback` is a function that is invoked after the message is
+ * sent but before the child may have received it. The function is called with a
+ * single argument: `null` on success, or an `Error` object on failure.
+ *
+ * If no `callback` function is provided and the message cannot be sent, an`'error'` event will be emitted by the `ChildProcess` object. This can
+ * happen, for instance, when the child process has already exited.
+ *
+ * `subprocess.send()` will return `false` if the channel has closed or when the
+ * backlog of unsent messages exceeds a threshold that makes it unwise to send
+ * more. Otherwise, the method returns `true`. The `callback` function can be
+ * used to implement flow control.
+ *
+ * #### Example: sending a server object
+ *
+ * The `sendHandle` argument can be used, for instance, to pass the handle of
+ * a TCP server object to the child process as illustrated in the example below:
+ *
+ * ```js
+ * const subprocess = require('child_process').fork('subprocess.js');
+ *
+ * // Open up the server object and send the handle.
+ * const server = require('net').createServer();
+ * server.on('connection', (socket) => {
+ * socket.end('handled by parent');
+ * });
+ * server.listen(1337, () => {
+ * subprocess.send('server', server);
+ * });
+ * ```
+ *
+ * The child would then receive the server object as:
+ *
+ * ```js
+ * process.on('message', (m, server) => {
+ * if (m === 'server') {
+ * server.on('connection', (socket) => {
+ * socket.end('handled by child');
+ * });
+ * }
+ * });
+ * ```
+ *
+ * Once the server is now shared between the parent and child, some connections
+ * can be handled by the parent and some by the child.
+ *
+ * While the example above uses a server created using the `net` module, `dgram`module servers use exactly the same workflow with the exceptions of listening on
+ * a `'message'` event instead of `'connection'` and using `server.bind()` instead
+ * of `server.listen()`. This is, however, currently only supported on Unix
+ * platforms.
+ *
+ * #### Example: sending a socket object
+ *
+ * Similarly, the `sendHandler` argument can be used to pass the handle of a
+ * socket to the child process. The example below spawns two children that each
+ * handle connections with "normal" or "special" priority:
+ *
+ * ```js
+ * const { fork } = require('child_process');
+ * const normal = fork('subprocess.js', ['normal']);
+ * const special = fork('subprocess.js', ['special']);
+ *
+ * // Open up the server and send sockets to child. Use pauseOnConnect to prevent
+ * // the sockets from being read before they are sent to the child process.
+ * const server = require('net').createServer({ pauseOnConnect: true });
+ * server.on('connection', (socket) => {
+ *
+ * // If this is special priority...
+ * if (socket.remoteAddress === '74.125.127.100') {
+ * special.send('socket', socket);
+ * return;
+ * }
+ * // This is normal priority.
+ * normal.send('socket', socket);
+ * });
+ * server.listen(1337);
+ * ```
+ *
+ * The `subprocess.js` would receive the socket handle as the second argument
+ * passed to the event callback function:
+ *
+ * ```js
+ * process.on('message', (m, socket) => {
+ * if (m === 'socket') {
+ * if (socket) {
+ * // Check that the client socket exists.
+ * // It is possible for the socket to be closed between the time it is
+ * // sent and the time it is received in the child process.
+ * socket.end(`Request handled with ${process.argv[2]} priority`);
+ * }
+ * }
+ * });
+ * ```
+ *
+ * Do not use `.maxConnections` on a socket that has been passed to a subprocess.
+ * The parent cannot track when the socket is destroyed.
+ *
+ * Any `'message'` handlers in the subprocess should verify that `socket` exists,
+ * as the connection may have been closed during the time it takes to send the
+ * connection to the child.
+ * @since v0.5.9
+ * @param options The `options` argument, if present, is an object used to parameterize the sending of certain types of handles. `options` supports the following properties:
+ */
send(message: Serializable, callback?: (error: Error | null) => void): boolean;
send(message: Serializable, sendHandle?: SendHandle, callback?: (error: Error | null) => void): boolean;
send(message: Serializable, sendHandle?: SendHandle, options?: MessageOptions, callback?: (error: Error | null) => void): boolean;
+ /**
+ * Closes the IPC channel between parent and child, allowing the child to exit
+ * gracefully once there are no other connections keeping it alive. After calling
+ * this method the `subprocess.connected` and `process.connected` properties in
+ * both the parent and child (respectively) will be set to `false`, and it will be
+ * no longer possible to pass messages between the processes.
+ *
+ * The `'disconnect'` event will be emitted when there are no messages in the
+ * process of being received. This will most often be triggered immediately after
+ * calling `subprocess.disconnect()`.
+ *
+ * When the child process is a Node.js instance (e.g. spawned using {@link fork}), the `process.disconnect()` method can be invoked
+ * within the child process to close the IPC channel as well.
+ * @since v0.7.2
+ */
disconnect(): void;
+ /**
+ * By default, the parent will wait for the detached child to exit. To prevent the
+ * parent from waiting for a given `subprocess` to exit, use the`subprocess.unref()` method. Doing so will cause the parent's event loop to not
+ * include the child in its reference count, allowing the parent to exit
+ * independently of the child, unless there is an established IPC channel between
+ * the child and the parent.
+ *
+ * ```js
+ * const { spawn } = require('child_process');
+ *
+ * const subprocess = spawn(process.argv[0], ['child_program.js'], {
+ * detached: true,
+ * stdio: 'ignore'
+ * });
+ *
+ * subprocess.unref();
+ * ```
+ * @since v0.7.10
+ */
unref(): void;
+ /**
+ * Calling `subprocess.ref()` after making a call to `subprocess.unref()` will
+ * restore the removed reference count for the child process, forcing the parent
+ * to wait for the child to exit before exiting itself.
+ *
+ * ```js
+ * const { spawn } = require('child_process');
+ *
+ * const subprocess = spawn(process.argv[0], ['child_program.js'], {
+ * detached: true,
+ * stdio: 'ignore'
+ * });
+ *
+ * subprocess.unref();
+ * subprocess.ref();
+ * ```
+ * @since v0.7.10
+ */
ref(): void;
-
/**
* events.EventEmitter
* 1. close
@@ -44,71 +520,68 @@ declare module 'child_process' {
* 3. error
* 4. exit
* 5. message
+ * 6. spawn
*/
-
addListener(event: string, listener: (...args: any[]) => void): this;
- addListener(event: "close", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
- addListener(event: "disconnect", listener: () => void): this;
- addListener(event: "error", listener: (err: Error) => void): this;
- addListener(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
- addListener(event: "message", listener: (message: Serializable, sendHandle: SendHandle) => void): this;
-
+ addListener(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+ addListener(event: 'disconnect', listener: () => void): this;
+ addListener(event: 'error', listener: (err: Error) => void): this;
+ addListener(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+ addListener(event: 'message', listener: (message: Serializable, sendHandle: SendHandle) => void): this;
+ addListener(event: 'spawn', listener: () => void): this;
emit(event: string | symbol, ...args: any[]): boolean;
- emit(event: "close", code: number | null, signal: NodeJS.Signals | null): boolean;
- emit(event: "disconnect"): boolean;
- emit(event: "error", err: Error): boolean;
- emit(event: "exit", code: number | null, signal: NodeJS.Signals | null): boolean;
- emit(event: "message", message: Serializable, sendHandle: SendHandle): boolean;
-
+ emit(event: 'close', code: number | null, signal: NodeJS.Signals | null): boolean;
+ emit(event: 'disconnect'): boolean;
+ emit(event: 'error', err: Error): boolean;
+ emit(event: 'exit', code: number | null, signal: NodeJS.Signals | null): boolean;
+ emit(event: 'message', message: Serializable, sendHandle: SendHandle): boolean;
+ emit(event: 'spawn', listener: () => void): boolean;
on(event: string, listener: (...args: any[]) => void): this;
- on(event: "close", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
- on(event: "disconnect", listener: () => void): this;
- on(event: "error", listener: (err: Error) => void): this;
- on(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
- on(event: "message", listener: (message: Serializable, sendHandle: SendHandle) => void): this;
-
+ on(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+ on(event: 'disconnect', listener: () => void): this;
+ on(event: 'error', listener: (err: Error) => void): this;
+ on(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+ on(event: 'message', listener: (message: Serializable, sendHandle: SendHandle) => void): this;
+ on(event: 'spawn', listener: () => void): this;
once(event: string, listener: (...args: any[]) => void): this;
- once(event: "close", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
- once(event: "disconnect", listener: () => void): this;
- once(event: "error", listener: (err: Error) => void): this;
- once(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
- once(event: "message", listener: (message: Serializable, sendHandle: SendHandle) => void): this;
-
+ once(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+ once(event: 'disconnect', listener: () => void): this;
+ once(event: 'error', listener: (err: Error) => void): this;
+ once(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+ once(event: 'message', listener: (message: Serializable, sendHandle: SendHandle) => void): this;
+ once(event: 'spawn', listener: () => void): this;
prependListener(event: string, listener: (...args: any[]) => void): this;
- prependListener(event: "close", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
- prependListener(event: "disconnect", listener: () => void): this;
- prependListener(event: "error", listener: (err: Error) => void): this;
- prependListener(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
- prependListener(event: "message", listener: (message: Serializable, sendHandle: SendHandle) => void): this;
-
+ prependListener(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+ prependListener(event: 'disconnect', listener: () => void): this;
+ prependListener(event: 'error', listener: (err: Error) => void): this;
+ prependListener(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+ prependListener(event: 'message', listener: (message: Serializable, sendHandle: SendHandle) => void): this;
+ prependListener(event: 'spawn', listener: () => void): this;
prependOnceListener(event: string, listener: (...args: any[]) => void): this;
- prependOnceListener(event: "close", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
- prependOnceListener(event: "disconnect", listener: () => void): this;
- prependOnceListener(event: "error", listener: (err: Error) => void): this;
- prependOnceListener(event: "exit", listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
- prependOnceListener(event: "message", listener: (message: Serializable, sendHandle: SendHandle) => void): this;
+ prependOnceListener(event: 'close', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+ prependOnceListener(event: 'disconnect', listener: () => void): this;
+ prependOnceListener(event: 'error', listener: (err: Error) => void): this;
+ prependOnceListener(event: 'exit', listener: (code: number | null, signal: NodeJS.Signals | null) => void): this;
+ prependOnceListener(event: 'message', listener: (message: Serializable, sendHandle: SendHandle) => void): this;
+ prependOnceListener(event: 'spawn', listener: () => void): this;
}
-
// return this object when stdio option is undefined or not specified
interface ChildProcessWithoutNullStreams extends ChildProcess {
stdin: Writable;
stdout: Readable;
stderr: Readable;
readonly stdio: [
- Writable, // stdin
- Readable, // stdout
- Readable, // stderr
- Readable | Writable | null | undefined, // extra, no modification
+ Writable,
+ Readable,
+ Readable,
+ // stderr
+ Readable | Writable | null | undefined,
+ // extra, no modification
Readable | Writable | null | undefined // extra, no modification
];
}
-
// return this object when stdio option is a tuple of 3
- interface ChildProcessByStdio<
- I extends null | Writable,
- O extends null | Readable,
- E extends null | Readable,
- > extends ChildProcess {
+ interface ChildProcessByStdio extends ChildProcess {
stdin: I;
stdout: O;
stderr: E;
@@ -116,37 +589,42 @@ declare module 'child_process' {
I,
O,
E,
- Readable | Writable | null | undefined, // extra, no modification
+ Readable | Writable | null | undefined,
+ // extra, no modification
Readable | Writable | null | undefined // extra, no modification
];
}
-
interface MessageOptions {
keepOpen?: boolean | undefined;
}
-
- type StdioOptions = "pipe" | "ignore" | "inherit" | Array<("pipe" | "ipc" | "ignore" | "inherit" | Stream | number | null | undefined)>;
-
+ type IOType = 'overlapped' | 'pipe' | 'ignore' | 'inherit';
+ type StdioOptions = IOType | Array;
type SerializationType = 'json' | 'advanced';
-
- interface MessagingOptions {
+ interface MessagingOptions extends Abortable {
/**
* Specify the kind of serialization used for sending messages between processes.
* @default 'json'
*/
serialization?: SerializationType | undefined;
+ /**
+ * The signal value to be used when the spawned process will be killed by the abort signal.
+ * @default 'SIGTERM'
+ */
+ killSignal?: NodeJS.Signals | number | undefined;
+ /**
+ * In milliseconds the maximum amount of time the process is allowed to run.
+ */
+ timeout?: number | undefined;
}
-
interface ProcessEnvOptions {
uid?: number | undefined;
gid?: number | undefined;
- cwd?: string | undefined;
+ cwd?: string | URL | undefined;
env?: NodeJS.ProcessEnv | undefined;
}
-
interface CommonOptions extends ProcessEnvOptions {
/**
- * @default true
+ * @default false
*/
windowsHide?: boolean | undefined;
/**
@@ -154,183 +632,348 @@ declare module 'child_process' {
*/
timeout?: number | undefined;
}
-
- interface CommonSpawnOptions extends CommonOptions, MessagingOptions {
+ interface CommonSpawnOptions extends CommonOptions, MessagingOptions, Abortable {
argv0?: string | undefined;
stdio?: StdioOptions | undefined;
shell?: boolean | string | undefined;
windowsVerbatimArguments?: boolean | undefined;
}
-
interface SpawnOptions extends CommonSpawnOptions {
detached?: boolean | undefined;
}
-
interface SpawnOptionsWithoutStdio extends SpawnOptions {
- stdio?: 'pipe' | Array | undefined;
+ stdio?: StdioPipeNamed | StdioPipe[] | undefined;
}
-
type StdioNull = 'inherit' | 'ignore' | Stream;
- type StdioPipe = undefined | null | 'pipe';
-
- interface SpawnOptionsWithStdioTuple<
- Stdin extends StdioNull | StdioPipe,
- Stdout extends StdioNull | StdioPipe,
- Stderr extends StdioNull | StdioPipe,
- > extends SpawnOptions {
+ type StdioPipeNamed = 'pipe' | 'overlapped';
+ type StdioPipe = undefined | null | StdioPipeNamed;
+ interface SpawnOptionsWithStdioTuple extends SpawnOptions {
stdio: [Stdin, Stdout, Stderr];
}
-
- // overloads of spawn without 'args'
+ /**
+ * The `child_process.spawn()` method spawns a new process using the given`command`, with command-line arguments in `args`. If omitted, `args` defaults
+ * to an empty array.
+ *
+ * **If the `shell` option is enabled, do not pass unsanitized user input to this**
+ * **function. Any input containing shell metacharacters may be used to trigger**
+ * **arbitrary command execution.**
+ *
+ * A third argument may be used to specify additional options, with these defaults:
+ *
+ * ```js
+ * const defaults = {
+ * cwd: undefined,
+ * env: process.env
+ * };
+ * ```
+ *
+ * Use `cwd` to specify the working directory from which the process is spawned.
+ * If not given, the default is to inherit the current working directory. If given,
+ * but the path does not exist, the child process emits an `ENOENT` error
+ * and exits immediately. `ENOENT` is also emitted when the command
+ * does not exist.
+ *
+ * Use `env` to specify environment variables that will be visible to the new
+ * process, the default is `process.env`.
+ *
+ * `undefined` values in `env` will be ignored.
+ *
+ * Example of running `ls -lh /usr`, capturing `stdout`, `stderr`, and the
+ * exit code:
+ *
+ * ```js
+ * const { spawn } = require('child_process');
+ * const ls = spawn('ls', ['-lh', '/usr']);
+ *
+ * ls.stdout.on('data', (data) => {
+ * console.log(`stdout: ${data}`);
+ * });
+ *
+ * ls.stderr.on('data', (data) => {
+ * console.error(`stderr: ${data}`);
+ * });
+ *
+ * ls.on('close', (code) => {
+ * console.log(`child process exited with code ${code}`);
+ * });
+ * ```
+ *
+ * Example: A very elaborate way to run `ps ax | grep ssh`
+ *
+ * ```js
+ * const { spawn } = require('child_process');
+ * const ps = spawn('ps', ['ax']);
+ * const grep = spawn('grep', ['ssh']);
+ *
+ * ps.stdout.on('data', (data) => {
+ * grep.stdin.write(data);
+ * });
+ *
+ * ps.stderr.on('data', (data) => {
+ * console.error(`ps stderr: ${data}`);
+ * });
+ *
+ * ps.on('close', (code) => {
+ * if (code !== 0) {
+ * console.log(`ps process exited with code ${code}`);
+ * }
+ * grep.stdin.end();
+ * });
+ *
+ * grep.stdout.on('data', (data) => {
+ * console.log(data.toString());
+ * });
+ *
+ * grep.stderr.on('data', (data) => {
+ * console.error(`grep stderr: ${data}`);
+ * });
+ *
+ * grep.on('close', (code) => {
+ * if (code !== 0) {
+ * console.log(`grep process exited with code ${code}`);
+ * }
+ * });
+ * ```
+ *
+ * Example of checking for failed `spawn`:
+ *
+ * ```js
+ * const { spawn } = require('child_process');
+ * const subprocess = spawn('bad_command');
+ *
+ * subprocess.on('error', (err) => {
+ * console.error('Failed to start subprocess.');
+ * });
+ * ```
+ *
+ * Certain platforms (macOS, Linux) will use the value of `argv[0]` for the process
+ * title while others (Windows, SunOS) will use `command`.
+ *
+ * Node.js currently overwrites `argv[0]` with `process.execPath` on startup, so`process.argv[0]` in a Node.js child process will not match the `argv0`parameter passed to `spawn` from the parent,
+ * retrieve it with the`process.argv0` property instead.
+ *
+ * If the `signal` option is enabled, calling `.abort()` on the corresponding`AbortController` is similar to calling `.kill()` on the child process except
+ * the error passed to the callback will be an `AbortError`:
+ *
+ * ```js
+ * const { spawn } = require('child_process');
+ * const controller = new AbortController();
+ * const { signal } = controller;
+ * const grep = spawn('grep', ['ssh'], { signal });
+ * grep.on('error', (err) => {
+ * // This will be called with err being an AbortError if the controller aborts
+ * });
+ * controller.abort(); // Stops the child process
+ * ```
+ * @since v0.1.90
+ * @param command The command to run.
+ * @param args List of string arguments.
+ */
function spawn(command: string, options?: SpawnOptionsWithoutStdio): ChildProcessWithoutNullStreams;
-
- function spawn(
- command: string,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
-
+ function spawn(command: string, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
function spawn(command: string, options: SpawnOptions): ChildProcess;
-
// overloads of spawn with 'args'
function spawn(command: string, args?: ReadonlyArray, options?: SpawnOptionsWithoutStdio): ChildProcessWithoutNullStreams;
-
- function spawn(
- command: string,
- args: ReadonlyArray,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- args: ReadonlyArray,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- args: ReadonlyArray,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- args: ReadonlyArray,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- args: ReadonlyArray,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- args: ReadonlyArray,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- args: ReadonlyArray,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
- function spawn(
- command: string,
- args: ReadonlyArray,
- options: SpawnOptionsWithStdioTuple,
- ): ChildProcessByStdio;
-
+ function spawn(command: string, args: ReadonlyArray, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, args: ReadonlyArray, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, args: ReadonlyArray, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, args: ReadonlyArray, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, args: ReadonlyArray, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, args: ReadonlyArray, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, args: ReadonlyArray, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
+ function spawn(command: string, args: ReadonlyArray, options: SpawnOptionsWithStdioTuple): ChildProcessByStdio;
function spawn(command: string, args: ReadonlyArray, options: SpawnOptions): ChildProcess;
-
interface ExecOptions extends CommonOptions {
shell?: string | undefined;
+ signal?: AbortSignal | undefined;
maxBuffer?: number | undefined;
killSignal?: NodeJS.Signals | number | undefined;
}
-
interface ExecOptionsWithStringEncoding extends ExecOptions {
encoding: BufferEncoding;
}
-
interface ExecOptionsWithBufferEncoding extends ExecOptions {
encoding: BufferEncoding | null; // specify `null`.
}
-
interface ExecException extends Error {
cmd?: string | undefined;
killed?: boolean | undefined;
code?: number | undefined;
signal?: NodeJS.Signals | undefined;
}
-
- // no `options` definitely means stdout/stderr are `string`.
+ /**
+ * Spawns a shell then executes the `command` within that shell, buffering any
+ * generated output. The `command` string passed to the exec function is processed
+ * directly by the shell and special characters (vary based on [shell](https://en.wikipedia.org/wiki/List_of_command-line_interpreters))
+ * need to be dealt with accordingly:
+ *
+ * ```js
+ * const { exec } = require('child_process');
+ *
+ * exec('"/path/to/test file/test.sh" arg1 arg2');
+ * // Double quotes are used so that the space in the path is not interpreted as
+ * // a delimiter of multiple arguments.
+ *
+ * exec('echo "The \\$HOME variable is $HOME"');
+ * // The $HOME variable is escaped in the first instance, but not in the second.
+ * ```
+ *
+ * **Never pass unsanitized user input to this function. Any input containing shell**
+ * **metacharacters may be used to trigger arbitrary command execution.**
+ *
+ * If a `callback` function is provided, it is called with the arguments`(error, stdout, stderr)`. On success, `error` will be `null`. On error,`error` will be an instance of `Error`. The
+ * `error.code` property will be
+ * the exit code of the process. By convention, any exit code other than `0`indicates an error. `error.signal` will be the signal that terminated the
+ * process.
+ *
+ * The `stdout` and `stderr` arguments passed to the callback will contain the
+ * stdout and stderr output of the child process. By default, Node.js will decode
+ * the output as UTF-8 and pass strings to the callback. The `encoding` option
+ * can be used to specify the character encoding used to decode the stdout and
+ * stderr output. If `encoding` is `'buffer'`, or an unrecognized character
+ * encoding, `Buffer` objects will be passed to the callback instead.
+ *
+ * ```js
+ * const { exec } = require('child_process');
+ * exec('cat *.js missing_file | wc -l', (error, stdout, stderr) => {
+ * if (error) {
+ * console.error(`exec error: ${error}`);
+ * return;
+ * }
+ * console.log(`stdout: ${stdout}`);
+ * console.error(`stderr: ${stderr}`);
+ * });
+ * ```
+ *
+ * If `timeout` is greater than `0`, the parent will send the signal
+ * identified by the `killSignal` property (the default is `'SIGTERM'`) if the
+ * child runs longer than `timeout` milliseconds.
+ *
+ * Unlike the [`exec(3)`](http://man7.org/linux/man-pages/man3/exec.3.html) POSIX system call, `child_process.exec()` does not replace
+ * the existing process and uses a shell to execute the command.
+ *
+ * If this method is invoked as its `util.promisify()` ed version, it returns
+ * a `Promise` for an `Object` with `stdout` and `stderr` properties. The returned`ChildProcess` instance is attached to the `Promise` as a `child` property. In
+ * case of an error (including any error resulting in an exit code other than 0), a
+ * rejected promise is returned, with the same `error` object given in the
+ * callback, but with two additional properties `stdout` and `stderr`.
+ *
+ * ```js
+ * const util = require('util');
+ * const exec = util.promisify(require('child_process').exec);
+ *
+ * async function lsExample() {
+ * const { stdout, stderr } = await exec('ls');
+ * console.log('stdout:', stdout);
+ * console.error('stderr:', stderr);
+ * }
+ * lsExample();
+ * ```
+ *
+ * If the `signal` option is enabled, calling `.abort()` on the corresponding`AbortController` is similar to calling `.kill()` on the child process except
+ * the error passed to the callback will be an `AbortError`:
+ *
+ * ```js
+ * const { exec } = require('child_process');
+ * const controller = new AbortController();
+ * const { signal } = controller;
+ * const child = exec('grep ssh', { signal }, (error) => {
+ * console.log(error); // an AbortError
+ * });
+ * controller.abort();
+ * ```
+ * @since v0.1.90
+ * @param command The command to run, with space-separated arguments.
+ * @param callback called with the output when process terminates.
+ */
function exec(command: string, callback?: (error: ExecException | null, stdout: string, stderr: string) => void): ChildProcess;
-
// `options` with `"buffer"` or `null` for `encoding` means stdout/stderr are definitely `Buffer`.
- function exec(command: string, options: { encoding: "buffer" | null } & ExecOptions, callback?: (error: ExecException | null, stdout: Buffer, stderr: Buffer) => void): ChildProcess;
-
+ function exec(
+ command: string,
+ options: {
+ encoding: 'buffer' | null;
+ } & ExecOptions,
+ callback?: (error: ExecException | null, stdout: Buffer, stderr: Buffer) => void
+ ): ChildProcess;
// `options` with well known `encoding` means stdout/stderr are definitely `string`.
- function exec(command: string, options: { encoding: BufferEncoding } & ExecOptions, callback?: (error: ExecException | null, stdout: string, stderr: string) => void): ChildProcess;
-
+ function exec(
+ command: string,
+ options: {
+ encoding: BufferEncoding;
+ } & ExecOptions,
+ callback?: (error: ExecException | null, stdout: string, stderr: string) => void
+ ): ChildProcess;
// `options` with an `encoding` whose type is `string` means stdout/stderr could either be `Buffer` or `string`.
// There is no guarantee the `encoding` is unknown as `string` is a superset of `BufferEncoding`.
function exec(
command: string,
- options: { encoding: BufferEncoding } & ExecOptions,
- callback?: (error: ExecException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
+ options: {
+ encoding: BufferEncoding;
+ } & ExecOptions,
+ callback?: (error: ExecException | null, stdout: string | Buffer, stderr: string | Buffer) => void
): ChildProcess;
-
// `options` without an `encoding` means stdout/stderr are definitely `string`.
function exec(command: string, options: ExecOptions, callback?: (error: ExecException | null, stdout: string, stderr: string) => void): ChildProcess;
-
// fallback if nothing else matches. Worst case is always `string | Buffer`.
function exec(
command: string,
- options: (BaseEncodingOptions & ExecOptions) | undefined | null,
- callback?: (error: ExecException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
+ options: (ObjectEncodingOptions & ExecOptions) | undefined | null,
+ callback?: (error: ExecException | null, stdout: string | Buffer, stderr: string | Buffer) => void
): ChildProcess;
-
interface PromiseWithChild extends Promise {
child: ChildProcess;
}
-
- // NOTE: This namespace provides design-time support for util.promisify. Exported members do not exist at runtime.
namespace exec {
- function __promisify__(command: string): PromiseWithChild<{ stdout: string, stderr: string }>;
- function __promisify__(command: string, options: { encoding: "buffer" | null } & ExecOptions): PromiseWithChild<{ stdout: Buffer, stderr: Buffer }>;
- function __promisify__(command: string, options: { encoding: BufferEncoding } & ExecOptions): PromiseWithChild<{ stdout: string, stderr: string }>;
- function __promisify__(command: string, options: ExecOptions): PromiseWithChild<{ stdout: string, stderr: string }>;
- function __promisify__(command: string, options?: (BaseEncodingOptions & ExecOptions) | null): PromiseWithChild<{ stdout: string | Buffer, stderr: string | Buffer }>;
+ function __promisify__(command: string): PromiseWithChild<{
+ stdout: string;
+ stderr: string;
+ }>;
+ function __promisify__(
+ command: string,
+ options: {
+ encoding: 'buffer' | null;
+ } & ExecOptions
+ ): PromiseWithChild<{
+ stdout: Buffer;
+ stderr: Buffer;
+ }>;
+ function __promisify__(
+ command: string,
+ options: {
+ encoding: BufferEncoding;
+ } & ExecOptions
+ ): PromiseWithChild<{
+ stdout: string;
+ stderr: string;
+ }>;
+ function __promisify__(
+ command: string,
+ options: ExecOptions
+ ): PromiseWithChild<{
+ stdout: string;
+ stderr: string;
+ }>;
+ function __promisify__(
+ command: string,
+ options?: (ObjectEncodingOptions & ExecOptions) | null
+ ): PromiseWithChild<{
+ stdout: string | Buffer;
+ stderr: string | Buffer;
+ }>;
}
-
- interface ExecFileOptions extends CommonOptions {
+ interface ExecFileOptions extends CommonOptions, Abortable {
maxBuffer?: number | undefined;
killSignal?: NodeJS.Signals | number | undefined;
windowsVerbatimArguments?: boolean | undefined;
shell?: boolean | string | undefined;
+ signal?: AbortSignal | undefined;
}
interface ExecFileOptionsWithStringEncoding extends ExecFileOptions {
encoding: BufferEncoding;
@@ -342,48 +985,101 @@ declare module 'child_process' {
encoding: BufferEncoding;
}
type ExecFileException = ExecException & NodeJS.ErrnoException;
-
+ /**
+ * The `child_process.execFile()` function is similar to {@link exec} except that it does not spawn a shell by default. Rather, the specified
+ * executable `file` is spawned directly as a new process making it slightly more
+ * efficient than {@link exec}.
+ *
+ * The same options as {@link exec} are supported. Since a shell is
+ * not spawned, behaviors such as I/O redirection and file globbing are not
+ * supported.
+ *
+ * ```js
+ * const { execFile } = require('child_process');
+ * const child = execFile('node', ['--version'], (error, stdout, stderr) => {
+ * if (error) {
+ * throw error;
+ * }
+ * console.log(stdout);
+ * });
+ * ```
+ *
+ * The `stdout` and `stderr` arguments passed to the callback will contain the
+ * stdout and stderr output of the child process. By default, Node.js will decode
+ * the output as UTF-8 and pass strings to the callback. The `encoding` option
+ * can be used to specify the character encoding used to decode the stdout and
+ * stderr output. If `encoding` is `'buffer'`, or an unrecognized character
+ * encoding, `Buffer` objects will be passed to the callback instead.
+ *
+ * If this method is invoked as its `util.promisify()` ed version, it returns
+ * a `Promise` for an `Object` with `stdout` and `stderr` properties. The returned`ChildProcess` instance is attached to the `Promise` as a `child` property. In
+ * case of an error (including any error resulting in an exit code other than 0), a
+ * rejected promise is returned, with the same `error` object given in the
+ * callback, but with two additional properties `stdout` and `stderr`.
+ *
+ * ```js
+ * const util = require('util');
+ * const execFile = util.promisify(require('child_process').execFile);
+ * async function getVersion() {
+ * const { stdout } = await execFile('node', ['--version']);
+ * console.log(stdout);
+ * }
+ * getVersion();
+ * ```
+ *
+ * **If the `shell` option is enabled, do not pass unsanitized user input to this**
+ * **function. Any input containing shell metacharacters may be used to trigger**
+ * **arbitrary command execution.**
+ *
+ * If the `signal` option is enabled, calling `.abort()` on the corresponding`AbortController` is similar to calling `.kill()` on the child process except
+ * the error passed to the callback will be an `AbortError`:
+ *
+ * ```js
+ * const { execFile } = require('child_process');
+ * const controller = new AbortController();
+ * const { signal } = controller;
+ * const child = execFile('node', ['--version'], { signal }, (error) => {
+ * console.log(error); // an AbortError
+ * });
+ * controller.abort();
+ * ```
+ * @since v0.1.91
+ * @param file The name or path of the executable file to run.
+ * @param args List of string arguments.
+ * @param callback Called with the output when process terminates.
+ */
function execFile(file: string): ChildProcess;
- function execFile(file: string, options: (BaseEncodingOptions & ExecFileOptions) | undefined | null): ChildProcess;
+ function execFile(file: string, options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null): ChildProcess;
function execFile(file: string, args?: ReadonlyArray | null): ChildProcess;
- function execFile(file: string, args: ReadonlyArray | undefined | null, options: (BaseEncodingOptions & ExecFileOptions) | undefined | null): ChildProcess;
-
+ function execFile(file: string, args: ReadonlyArray | undefined | null, options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null): ChildProcess;
// no `options` definitely means stdout/stderr are `string`.
function execFile(file: string, callback: (error: ExecFileException | null, stdout: string, stderr: string) => void): ChildProcess;
function execFile(file: string, args: ReadonlyArray | undefined | null, callback: (error: ExecFileException | null, stdout: string, stderr: string) => void): ChildProcess;
-
// `options` with `"buffer"` or `null` for `encoding` means stdout/stderr are definitely `Buffer`.
function execFile(file: string, options: ExecFileOptionsWithBufferEncoding, callback: (error: ExecFileException | null, stdout: Buffer, stderr: Buffer) => void): ChildProcess;
function execFile(
file: string,
args: ReadonlyArray | undefined | null,
options: ExecFileOptionsWithBufferEncoding,
- callback: (error: ExecFileException | null, stdout: Buffer, stderr: Buffer) => void,
+ callback: (error: ExecFileException | null, stdout: Buffer, stderr: Buffer) => void
): ChildProcess;
-
// `options` with well known `encoding` means stdout/stderr are definitely `string`.
function execFile(file: string, options: ExecFileOptionsWithStringEncoding, callback: (error: ExecFileException | null, stdout: string, stderr: string) => void): ChildProcess;
function execFile(
file: string,
args: ReadonlyArray | undefined | null,
options: ExecFileOptionsWithStringEncoding,
- callback: (error: ExecFileException | null, stdout: string, stderr: string) => void,
+ callback: (error: ExecFileException | null, stdout: string, stderr: string) => void
): ChildProcess;
-
// `options` with an `encoding` whose type is `string` means stdout/stderr could either be `Buffer` or `string`.
// There is no guarantee the `encoding` is unknown as `string` is a superset of `BufferEncoding`.
- function execFile(
- file: string,
- options: ExecFileOptionsWithOtherEncoding,
- callback: (error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
- ): ChildProcess;
+ function execFile(file: string, options: ExecFileOptionsWithOtherEncoding, callback: (error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void): ChildProcess;
function execFile(
file: string,
args: ReadonlyArray | undefined | null,
options: ExecFileOptionsWithOtherEncoding,
- callback: (error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void,
+ callback: (error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void
): ChildProcess;
-
// `options` without an `encoding` means stdout/stderr are definitely `string`.
function execFile(file: string, options: ExecFileOptions, callback: (error: ExecFileException | null, stdout: string, stderr: string) => void): ChildProcess;
function execFile(
@@ -392,45 +1088,107 @@ declare module 'child_process' {
options: ExecFileOptions,
callback: (error: ExecFileException | null, stdout: string, stderr: string) => void
): ChildProcess;
-
// fallback if nothing else matches. Worst case is always `string | Buffer`.
function execFile(
file: string,
- options: (BaseEncodingOptions & ExecFileOptions) | undefined | null,
- callback: ((error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void) | undefined | null,
+ options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
+ callback: ((error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void) | undefined | null
): ChildProcess;
function execFile(
file: string,
args: ReadonlyArray | undefined | null,
- options: (BaseEncodingOptions & ExecFileOptions) | undefined | null,
- callback: ((error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void) | undefined | null,
+ options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null,
+ callback: ((error: ExecFileException | null, stdout: string | Buffer, stderr: string | Buffer) => void) | undefined | null
): ChildProcess;
-
- // NOTE: This namespace provides design-time support for util.promisify. Exported members do not exist at runtime.
namespace execFile {
- function __promisify__(file: string): PromiseWithChild<{ stdout: string, stderr: string }>;
- function __promisify__(file: string, args: ReadonlyArray | undefined | null): PromiseWithChild<{ stdout: string, stderr: string }>;
- function __promisify__(file: string, options: ExecFileOptionsWithBufferEncoding): PromiseWithChild<{ stdout: Buffer, stderr: Buffer }>;
- function __promisify__(file: string, args: ReadonlyArray | undefined | null, options: ExecFileOptionsWithBufferEncoding): PromiseWithChild<{ stdout: Buffer, stderr: Buffer }>;
- function __promisify__(file: string, options: ExecFileOptionsWithStringEncoding): PromiseWithChild<{ stdout: string, stderr: string }>;
- function __promisify__(file: string, args: ReadonlyArray | undefined | null, options: ExecFileOptionsWithStringEncoding): PromiseWithChild<{ stdout: string, stderr: string }>;
- function __promisify__(file: string, options: ExecFileOptionsWithOtherEncoding): PromiseWithChild<{ stdout: string | Buffer, stderr: string | Buffer }>;
+ function __promisify__(file: string): PromiseWithChild<{
+ stdout: string;
+ stderr: string;
+ }>;
+ function __promisify__(
+ file: string,
+ args: ReadonlyArray | undefined | null
+ ): PromiseWithChild<{
+ stdout: string;
+ stderr: string;
+ }>;
+ function __promisify__(
+ file: string,
+ options: ExecFileOptionsWithBufferEncoding
+ ): PromiseWithChild<{
+ stdout: Buffer;
+ stderr: Buffer;
+ }>;
function __promisify__(
file: string,
args: ReadonlyArray | undefined | null,
- options: ExecFileOptionsWithOtherEncoding,
- ): PromiseWithChild<{ stdout: string | Buffer, stderr: string | Buffer }>;
- function __promisify__(file: string, options: ExecFileOptions): PromiseWithChild<{ stdout: string, stderr: string }>;
- function __promisify__(file: string, args: ReadonlyArray | undefined | null, options: ExecFileOptions): PromiseWithChild<{ stdout: string, stderr: string }>;
- function __promisify__(file: string, options: (BaseEncodingOptions & ExecFileOptions) | undefined | null): PromiseWithChild<{ stdout: string | Buffer, stderr: string | Buffer }>;
+ options: ExecFileOptionsWithBufferEncoding
+ ): PromiseWithChild<{
+ stdout: Buffer;
+ stderr: Buffer;
+ }>;
+ function __promisify__(
+ file: string,
+ options: ExecFileOptionsWithStringEncoding
+ ): PromiseWithChild<{
+ stdout: string;
+ stderr: string;
+ }>;
function __promisify__(
file: string,
args: ReadonlyArray | undefined | null,
- options: (BaseEncodingOptions & ExecFileOptions) | undefined | null,
- ): PromiseWithChild<{ stdout: string | Buffer, stderr: string | Buffer }>;
+ options: ExecFileOptionsWithStringEncoding
+ ): PromiseWithChild<{
+ stdout: string;
+ stderr: string;
+ }>;
+ function __promisify__(
+ file: string,
+ options: ExecFileOptionsWithOtherEncoding
+ ): PromiseWithChild<{
+ stdout: string | Buffer;
+ stderr: string | Buffer;
+ }>;
+ function __promisify__(
+ file: string,
+ args: ReadonlyArray | undefined | null,
+ options: ExecFileOptionsWithOtherEncoding
+ ): PromiseWithChild<{
+ stdout: string | Buffer;
+ stderr: string | Buffer;
+ }>;
+ function __promisify__(
+ file: string,
+ options: ExecFileOptions
+ ): PromiseWithChild<{
+ stdout: string;
+ stderr: string;
+ }>;
+ function __promisify__(
+ file: string,
+ args: ReadonlyArray | undefined | null,
+ options: ExecFileOptions
+ ): PromiseWithChild<{
+ stdout: string;
+ stderr: string;
+ }>;
+ function __promisify__(
+ file: string,
+ options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null
+ ): PromiseWithChild<{
+ stdout: string | Buffer;
+ stderr: string | Buffer;
+ }>;
+ function __promisify__(
+ file: string,
+ args: ReadonlyArray | undefined | null,
+ options: (ObjectEncodingOptions & ExecFileOptions) | undefined | null
+ ): PromiseWithChild<{
+ stdout: string | Buffer;
+ stderr: string | Buffer;
+ }>;
}
-
- interface ForkOptions extends ProcessEnvOptions, MessagingOptions {
+ interface ForkOptions extends ProcessEnvOptions, MessagingOptions, Abortable {
execPath?: string | undefined;
execArgv?: string[] | undefined;
silent?: boolean | undefined;
@@ -438,12 +1196,59 @@ declare module 'child_process' {
detached?: boolean | undefined;
windowsVerbatimArguments?: boolean | undefined;
}
+ /**
+ * The `child_process.fork()` method is a special case of {@link spawn} used specifically to spawn new Node.js processes.
+ * Like {@link spawn}, a `ChildProcess` object is returned. The
+ * returned `ChildProcess` will have an additional communication channel
+ * built-in that allows messages to be passed back and forth between the parent and
+ * child. See `subprocess.send()` for details.
+ *
+ * Keep in mind that spawned Node.js child processes are
+ * independent of the parent with exception of the IPC communication channel
+ * that is established between the two. Each process has its own memory, with
+ * their own V8 instances. Because of the additional resource allocations
+ * required, spawning a large number of child Node.js processes is not
+ * recommended.
+ *
+ * By default, `child_process.fork()` will spawn new Node.js instances using the `process.execPath` of the parent process. The `execPath` property in the`options` object allows for an alternative
+ * execution path to be used.
+ *
+ * Node.js processes launched with a custom `execPath` will communicate with the
+ * parent process using the file descriptor (fd) identified using the
+ * environment variable `NODE_CHANNEL_FD` on the child process.
+ *
+ * Unlike the [`fork(2)`](http://man7.org/linux/man-pages/man2/fork.2.html) POSIX system call, `child_process.fork()` does not clone the
+ * current process.
+ *
+ * The `shell` option available in {@link spawn} is not supported by`child_process.fork()` and will be ignored if set.
+ *
+ * If the `signal` option is enabled, calling `.abort()` on the corresponding`AbortController` is similar to calling `.kill()` on the child process except
+ * the error passed to the callback will be an `AbortError`:
+ *
+ * ```js
+ * if (process.argv[2] === 'child') {
+ * setTimeout(() => {
+ * console.log(`Hello from ${process.argv[2]}!`);
+ * }, 1_000);
+ * } else {
+ * const { fork } = require('child_process');
+ * const controller = new AbortController();
+ * const { signal } = controller;
+ * const child = fork(__filename, ['child'], { signal });
+ * child.on('error', (err) => {
+ * // This will be called with err being an AbortError if the controller aborts
+ * });
+ * controller.abort(); // Stops the child process
+ * }
+ * ```
+ * @since v0.5.0
+ * @param modulePath The module to run in the child.
+ * @param args List of string arguments.
+ */
function fork(modulePath: string, options?: ForkOptions): ChildProcess;
function fork(modulePath: string, args?: ReadonlyArray, options?: ForkOptions): ChildProcess;
-
interface SpawnSyncOptions extends CommonSpawnOptions {
input?: string | NodeJS.ArrayBufferView | undefined;
- killSignal?: NodeJS.Signals | number | undefined;
maxBuffer?: number | undefined;
encoding?: BufferEncoding | 'buffer' | null | undefined;
}
@@ -462,55 +1267,102 @@ declare module 'child_process' {
signal: NodeJS.Signals | null;
error?: Error | undefined;
}
+ /**
+ * The `child_process.spawnSync()` method is generally identical to {@link spawn} with the exception that the function will not return
+ * until the child process has fully closed. When a timeout has been encountered
+ * and `killSignal` is sent, the method won't return until the process has
+ * completely exited. If the process intercepts and handles the `SIGTERM` signal
+ * and doesn't exit, the parent process will wait until the child process has
+ * exited.
+ *
+ * **If the `shell` option is enabled, do not pass unsanitized user input to this**
+ * **function. Any input containing shell metacharacters may be used to trigger**
+ * **arbitrary command execution.**
+ * @since v0.11.12
+ * @param command The command to run.
+ * @param args List of string arguments.
+ */
function spawnSync(command: string): SpawnSyncReturns;
- function spawnSync(command: string, options?: SpawnSyncOptionsWithStringEncoding): SpawnSyncReturns;
- function spawnSync(command: string, options?: SpawnSyncOptionsWithBufferEncoding): SpawnSyncReturns;
+ function spawnSync(command: string, options: SpawnSyncOptionsWithStringEncoding): SpawnSyncReturns;
+ function spawnSync(command: string, options: SpawnSyncOptionsWithBufferEncoding): SpawnSyncReturns;
function spawnSync(command: string, options?: SpawnSyncOptions): SpawnSyncReturns;
- function spawnSync(command: string, args?: ReadonlyArray, options?: SpawnSyncOptionsWithStringEncoding): SpawnSyncReturns;
- function spawnSync(command: string, args?: ReadonlyArray, options?: SpawnSyncOptionsWithBufferEncoding): SpawnSyncReturns;
+ function spawnSync(command: string, args: ReadonlyArray): SpawnSyncReturns;
+ function spawnSync(command: string, args: ReadonlyArray, options: SpawnSyncOptionsWithStringEncoding): SpawnSyncReturns;
+ function spawnSync(command: string, args: ReadonlyArray, options: SpawnSyncOptionsWithBufferEncoding): SpawnSyncReturns;
function spawnSync(command: string, args?: ReadonlyArray, options?: SpawnSyncOptions): SpawnSyncReturns;
-
- interface ExecSyncOptions extends CommonOptions {
- input?: string | Uint8Array | undefined;
+ interface CommonExecOptions extends CommonOptions {
+ input?: string | NodeJS.ArrayBufferView | undefined;
stdio?: StdioOptions | undefined;
- shell?: string | undefined;
killSignal?: NodeJS.Signals | number | undefined;
maxBuffer?: number | undefined;
encoding?: BufferEncoding | 'buffer' | null | undefined;
}
+ interface ExecSyncOptions extends CommonExecOptions {
+ shell?: string | undefined;
+ }
interface ExecSyncOptionsWithStringEncoding extends ExecSyncOptions {
encoding: BufferEncoding;
}
interface ExecSyncOptionsWithBufferEncoding extends ExecSyncOptions {
encoding?: 'buffer' | null | undefined;
}
+ /**
+ * The `child_process.execSync()` method is generally identical to {@link exec} with the exception that the method will not return
+ * until the child process has fully closed. When a timeout has been encountered
+ * and `killSignal` is sent, the method won't return until the process has
+ * completely exited. If the child process intercepts and handles the `SIGTERM`signal and doesn't exit, the parent process will wait until the child process
+ * has exited.
+ *
+ * If the process times out or has a non-zero exit code, this method will throw.
+ * The `Error` object will contain the entire result from {@link spawnSync}.
+ *
+ * **Never pass unsanitized user input to this function. Any input containing shell**
+ * **metacharacters may be used to trigger arbitrary command execution.**
+ * @since v0.11.12
+ * @param command The command to run.
+ * @return The stdout from the command.
+ */
function execSync(command: string): Buffer;
function execSync(command: string, options: ExecSyncOptionsWithStringEncoding): string;
function execSync(command: string, options: ExecSyncOptionsWithBufferEncoding): Buffer;
function execSync(command: string, options?: ExecSyncOptions): string | Buffer;
-
- interface ExecFileSyncOptions extends CommonOptions {
- input?: string | NodeJS.ArrayBufferView | undefined;
- stdio?: StdioOptions | undefined;
- killSignal?: NodeJS.Signals | number | undefined;
- maxBuffer?: number | undefined;
- encoding?: BufferEncoding | undefined;
+ interface ExecFileSyncOptions extends CommonExecOptions {
shell?: boolean | string | undefined;
}
interface ExecFileSyncOptionsWithStringEncoding extends ExecFileSyncOptions {
encoding: BufferEncoding;
}
interface ExecFileSyncOptionsWithBufferEncoding extends ExecFileSyncOptions {
- encoding: BufferEncoding; // specify `null`.
+ encoding?: 'buffer' | null; // specify `null`.
}
- function execFileSync(command: string): Buffer;
- function execFileSync(command: string, options: ExecFileSyncOptionsWithStringEncoding): string;
- function execFileSync(command: string, options: ExecFileSyncOptionsWithBufferEncoding): Buffer;
- function execFileSync(command: string, options?: ExecFileSyncOptions): string | Buffer;
- function execFileSync(command: string, args: ReadonlyArray