├── .editorconfig
├── .eslintignore
├── .eslintrc.js
├── .gitignore
├── .npmignore
├── .travis.yml
├── CONTRIBUTING.md
├── LICENSE
├── README.md
├── build.js
├── debug.js
├── docs
└── issue_template.md
├── front_end
├── favicon.png
├── ndb.html
├── ndb.js
├── ndb.json
├── ndb
│ ├── Connection.js
│ ├── FileSystem.js
│ ├── InspectorFrontendHostOverrides.js
│ ├── NdbMain.js
│ └── module.json
├── ndb_sdk
│ ├── NodeRuntime.js
│ ├── NodeWorker.js
│ └── module.json
├── ndb_ui
│ ├── NodeProcesses.js
│ ├── RunConfiguration.js
│ ├── Terminal.js
│ ├── module.json
│ ├── nodeProcesses.css
│ └── runConfiguration.css
└── xterm
│ └── module.json
├── lib
├── backend.js
├── filepath_to_url.js
├── launcher.js
├── preload
│ └── ndb
│ │ └── preload.js
└── process_utility.js
├── ndb.js
├── package-lock.json
├── package.json
├── scripts
└── builder.js
├── services
├── file_system.js
├── file_system_io.js
├── ndd_service.js
├── search.js
└── terminal.js
├── test
├── assets
│ └── test-project
│ │ ├── index.js
│ │ ├── index.mjs
│ │ └── package.json
├── basic.spec.js
├── integration.js
└── platform.spec.js
├── utils
└── testrunner
│ ├── Matchers.js
│ ├── Multimap.js
│ ├── README.md
│ ├── Reporter.js
│ ├── TestRunner.js
│ ├── examples
│ ├── fail.js
│ ├── hookfail.js
│ ├── hooktimeout.js
│ ├── timeout.js
│ └── unhandledpromiserejection.js
│ └── index.js
└── version.js
/.editorconfig:
--------------------------------------------------------------------------------
1 | root = true
2 |
3 | [*]
4 | indent_style = space
5 | indent_size = 2
6 | end_of_line = lf
7 | charset = utf-8
8 | trim_trailing_whitespace = true
9 | insert_final_newline = true
10 |
--------------------------------------------------------------------------------
/.eslintignore:
--------------------------------------------------------------------------------
1 | test/test.js
2 | utils/testrunner/
3 |
--------------------------------------------------------------------------------
/.eslintrc.js:
--------------------------------------------------------------------------------
1 | module.exports = {
2 | "root": true,
3 |
4 | "env": {
5 | "node": true,
6 | "es6": true
7 | },
8 |
9 | "parserOptions": {
10 | "ecmaVersion": 9
11 | },
12 |
13 | /**
14 | * ESLint rules
15 | *
16 | * All available rules: http://eslint.org/docs/rules/
17 | *
18 | * Rules take the following form:
19 | * "rule-name", [severity, { opts }]
20 | * Severity: 2 == error, 1 == warning, 0 == off.
21 | */
22 | "rules": {
23 | /**
24 | * Enforced rules
25 | */
26 |
27 |
28 | // syntax preferences
29 | "quotes": [2, "single", {
30 | "avoidEscape": true,
31 | "allowTemplateLiterals": true
32 | }],
33 | "semi": 2,
34 | "no-extra-semi": 2,
35 | "comma-style": [2, "last"],
36 | "wrap-iife": [2, "inside"],
37 | "spaced-comment": [2, "always", {
38 | "markers": ["*"]
39 | }],
40 | "eqeqeq": [2],
41 | "arrow-body-style": [2, "as-needed"],
42 | "accessor-pairs": [2, {
43 | "getWithoutSet": false,
44 | "setWithoutGet": false
45 | }],
46 | "brace-style": [2, "1tbs", {"allowSingleLine": true}],
47 | "curly": [2, "multi-or-nest", "consistent"],
48 | "new-parens": 2,
49 | "func-call-spacing": 2,
50 | "arrow-parens": [2, "as-needed"],
51 | "prefer-const": 2,
52 | "quote-props": [2, "consistent"],
53 |
54 | // anti-patterns
55 | "no-var": 2,
56 | "no-with": 2,
57 | "no-multi-str": 2,
58 | "no-caller": 2,
59 | "no-implied-eval": 2,
60 | "no-labels": 2,
61 | "no-new-object": 2,
62 | "no-octal-escape": 2,
63 | "no-self-compare": 2,
64 | "no-shadow-restricted-names": 2,
65 | "no-cond-assign": 2,
66 | "no-debugger": 2,
67 | "no-dupe-keys": 2,
68 | "no-duplicate-case": 2,
69 | "no-empty-character-class": 2,
70 | "no-unreachable": 2,
71 | "no-unsafe-negation": 2,
72 | "radix": 2,
73 | "valid-typeof": 2,
74 | "no-unused-vars": [2, { "args": "none", "vars": "local", "varsIgnorePattern": "(_|load)" }],
75 | "no-implicit-globals": [2],
76 |
77 | // es2015 features
78 | "require-yield": 2,
79 | "template-curly-spacing": [2, "never"],
80 |
81 | // spacing details
82 | "space-infix-ops": 2,
83 | "space-in-parens": [2, "never"],
84 | "space-before-function-paren": [2, "never"],
85 | "no-whitespace-before-property": 2,
86 | "keyword-spacing": [2, {
87 | "overrides": {
88 | "if": {"after": true},
89 | "else": {"after": true},
90 | "for": {"after": true},
91 | "while": {"after": true},
92 | "do": {"after": true},
93 | "switch": {"after": true},
94 | "return": {"after": true}
95 | }
96 | }],
97 | "arrow-spacing": [2, {
98 | "after": true,
99 | "before": true
100 | }],
101 |
102 | // file whitespace
103 | "no-multiple-empty-lines": [2, {"max": 2}],
104 | "no-mixed-spaces-and-tabs": 2,
105 | "no-trailing-spaces": 2,
106 | "linebreak-style": [ process.platform === "win32" ? 0 : 2, "unix" ],
107 | "indent": [2, 2, { "SwitchCase": 1, "CallExpression": {"arguments": 2}, "MemberExpression": 2 }],
108 | "key-spacing": [2, {
109 | "beforeColon": false
110 | }]
111 | }
112 | };
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | /.local-frontend/
2 | /node_modules/
3 | .DS_Store
4 | *.swp
5 | *.pyc
6 | .vscode
7 | package-lock.json
8 | yarn.lock
9 |
--------------------------------------------------------------------------------
/.npmignore:
--------------------------------------------------------------------------------
1 | # exclude all tests
2 | test/
3 | test/fs/
4 | utils/testrunner
5 |
6 | # repeats from .gitignore
7 | /node_modules/
8 | .DS_Store
9 | *.swp
10 | *.pyc
11 | .vscode
12 | package-lock.json
13 | yarn.lock
14 |
15 | # other
16 | .editorconfig
17 | .eslintignore
18 | .eslintrc.js
19 | README.md
20 | ndb-*.tgz
21 |
--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
1 | language: node_js
2 | node_js:
3 | - "12"
4 | - "10"
5 |
--------------------------------------------------------------------------------
/CONTRIBUTING.md:
--------------------------------------------------------------------------------
1 | # How to Contribute
2 |
3 | First of all, thank you for your interest in ndb!
4 | We'd love to accept your patches and contributions!
5 |
6 | ## Contributor License Agreement
7 |
8 | Contributions to this project must be accompanied by a Contributor License
9 | Agreement. You (or your employer) retain the copyright to your contribution,
10 | this simply gives us permission to use and redistribute your contributions as
11 | part of the project. Head over to to see
12 | your current agreements on file or to sign a new one.
13 |
14 | You generally only need to submit a CLA once, so if you've already submitted one
15 | (even if it was for a different project), you probably don't need to do it
16 | again.
17 |
18 | ## Getting setup
19 |
20 | 1. Clone this repository
21 |
22 | ```bash
23 | git clone https://github.com/GoogleChromeLabs/ndb
24 | cd ndb
25 | ```
26 |
27 | 2. Install dependencies
28 |
29 | ```bash
30 | npm install
31 | ```
32 |
33 | ## Code reviews
34 |
35 | All submissions, including submissions by project members, require review. We
36 | use GitHub pull requests for this purpose. Consult
37 | [GitHub Help](https://help.github.com/articles/about-pull-requests/) for more
38 | information on using pull requests.
39 |
40 | ## Code Style
41 |
42 | - Coding style is fully defined in [.eslintrc](https://github.com/GoogleChrome/puppeteer/blob/master/.eslintrc.js)
43 | - Code should be annotated with [closure annotations](https://github.com/google/closure-compiler/wiki/Annotating-JavaScript-for-the-Closure-Compiler).
44 | - Comments should be generally avoided. If the code would not be understood without comments, consider re-writing the code to make it self-explanatory.
45 |
46 | To run code linter, use:
47 |
48 | ```bash
49 | npm run lint
50 | ```
51 |
52 | ## Commit Messages
53 |
54 | Commit messages should follow the Semantic Commit Messages format:
55 |
56 | ```
57 | label(namespace): title
58 |
59 | description
60 |
61 | footer
62 | ```
63 |
64 | 1. *label* is one of the following:
65 | - `fix` - ndb bug fixes.
66 | - `feat` - ndb features.
67 | - `docs` - changes to docs, e.g. `docs(api.md): ..` to change documentation.
68 | - `test` - changes to ndb tests infrastructure.
69 | - `style` - ndb code style: spaces/alignment/wrapping etc.
70 | - `chore` - build-related work.
71 | 2. *namespace* is put in parenthesis after label and is **optional**.
72 | 3. *title* is a brief summary of changes.
73 | 4. *description* is **optional**, new-line separated from title and is in present tense.
74 | 5. *footer* is **optional**, new-line separated from *description* and contains "fixes" / "references" attribution to github issues.
75 |
76 | Example:
77 |
78 | ```
79 | fix(NddService): fix NddService.attach method
80 |
81 | This patch fixes NddService.attach so that it works with Node 12.
82 |
83 | Fixes #123, Fixes #234
84 | ```
85 |
86 | ## Adding New Dependencies
87 |
88 | For all dependencies (both installation and development):
89 | - **Do not add** a dependency if the desired functionality is easily implementable.
90 | - If adding a dependency, it should be well-maintained and trustworthy.
91 |
92 | A barrier for introducing new installation dependencies is especially high:
93 | - **Do not add** installation dependency unless it's critical to project success.
94 |
95 | ## Writing Tests
96 |
97 | - Every ndb service feature should be accompanied by a test.
98 | - Tests should be *hermetic*. Tests should not depend on external services.
99 | - Tests should work on all three platforms: Mac, Linux and Win.
100 |
101 | ndb tests are located in [test/test.js](https://github.com/GoogleChromeLabs/ndb/blob/master/test/test.js)
102 | and are written with a [mocha](https://mochajs.org/) framework.
103 |
104 | - To run all tests:
105 |
106 | ```bash
107 | npm run unit
108 | ```
109 |
110 | - To run a specific test, substitute the `it` with `fit` (mnemonic rule: '*focus it*'):
111 |
112 | ```js
113 | ...
114 | // Using "fit" to run specific test
115 | fit('should work', async function({service}) {
116 | const response = await service.method();
117 | expect(response).toBe(true);
118 | })
119 | ```
120 |
121 | - To disable a specific test, substitute the `it` with `xit` (mnemonic rule: '*cross it*'):
122 |
123 | ```js
124 | ...
125 | // Using "xit" to skip specific test
126 | xit('should work', async function({service}) {
127 | const response = await service.method();
128 | expect(response).toBe(true);
129 | })
130 | ```
131 |
132 | ## Developing ndb hints
133 |
134 | - Environment variable NDB_DEBUG_FRONTEND=1 forces ndb to fetch
135 | frontend from front_end folder and chrome-devtools-frontend
136 | package.
137 |
138 | ```bash
139 | NDB_DEBUG_FRONTEND=1 ndb .
140 | ```
141 |
142 | - To debug ndb by itself or any ndb service you can use ndb.
143 | ```bash
144 | NDB_DEBUG_FRONTEND=1 ndb ndb index.js
145 | ```
146 |
147 | - To debug running Chrome DevTools frontend you can open DevTools,
148 | use Ctrl+Shift+I on Linux or View > Developer > Developer Tools menu
149 | item on Mac OS.
150 |
151 | ## [For Project Maintainers] Releasing to NPM
152 |
153 | Releasing to NPM consists of 3 phases:
154 | 1. Source Code: mark a release.
155 | 1. Bump `package.json` version following the SEMVER rules and send a PR titled `'chore: mark version vXXX.YYY.ZZZ'`.
156 | 2. Make sure the PR passes **all checks**.
157 | 3. Merge the PR.
158 | 4. Once merged, publish release notes using the "create new tag" option.
159 | - **NOTE**: tag names are prefixed with `'v'`, e.g. for version `1.4.0` tag is `v1.4.0`.
160 | 2. Publish to NPM.
161 | 1. On your local machine, pull from [upstream](https://github.com/GoogleChromeLabs/ndb) and make sure the last commit is the one just merged.
162 | 2. Run `git status` and make sure there are no untracked files.
163 | - **WHY**: this is to avoid bundling unnecessary files to NPM package
164 | 3. Run [`pkgfiles`](https://www.npmjs.com/package/pkgfiles) to make sure you don't publish anything unnecessary.
165 | 4. Run `npm publish`.
166 | 3. Source Code: mark post-release.
167 | 1. Bump `package.json` version to `-post` version and send a PR titled `'chore: bump version to vXXX.YYY.ZZZ-post'`
168 | - **NOTE**: no other commits should be landed in-between release commit and bump commit.
169 |
170 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 |
2 | Apache License
3 | Version 2.0, January 2004
4 | http://www.apache.org/licenses/
5 |
6 | TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
7 |
8 | 1. Definitions.
9 |
10 | "License" shall mean the terms and conditions for use, reproduction,
11 | and distribution as defined by Sections 1 through 9 of this document.
12 |
13 | "Licensor" shall mean the copyright owner or entity authorized by
14 | the copyright owner that is granting the License.
15 |
16 | "Legal Entity" shall mean the union of the acting entity and all
17 | other entities that control, are controlled by, or are under common
18 | control with that entity. For the purposes of this definition,
19 | "control" means (i) the power, direct or indirect, to cause the
20 | direction or management of such entity, whether by contract or
21 | otherwise, or (ii) ownership of fifty percent (50%) or more of the
22 | outstanding shares, or (iii) beneficial ownership of such entity.
23 |
24 | "You" (or "Your") shall mean an individual or Legal Entity
25 | exercising permissions granted by this License.
26 |
27 | "Source" form shall mean the preferred form for making modifications,
28 | including but not limited to software source code, documentation
29 | source, and configuration files.
30 |
31 | "Object" form shall mean any form resulting from mechanical
32 | transformation or translation of a Source form, including but
33 | not limited to compiled object code, generated documentation,
34 | and conversions to other media types.
35 |
36 | "Work" shall mean the work of authorship, whether in Source or
37 | Object form, made available under the License, as indicated by a
38 | copyright notice that is included in or attached to the work
39 | (an example is provided in the Appendix below).
40 |
41 | "Derivative Works" shall mean any work, whether in Source or Object
42 | form, that is based on (or derived from) the Work and for which the
43 | editorial revisions, annotations, elaborations, or other modifications
44 | represent, as a whole, an original work of authorship. For the purposes
45 | of this License, Derivative Works shall not include works that remain
46 | separable from, or merely link (or bind by name) to the interfaces of,
47 | the Work and Derivative Works thereof.
48 |
49 | "Contribution" shall mean any work of authorship, including
50 | the original version of the Work and any modifications or additions
51 | to that Work or Derivative Works thereof, that is intentionally
52 | submitted to Licensor for inclusion in the Work by the copyright owner
53 | or by an individual or Legal Entity authorized to submit on behalf of
54 | the copyright owner. For the purposes of this definition, "submitted"
55 | means any form of electronic, verbal, or written communication sent
56 | to the Licensor or its representatives, including but not limited to
57 | communication on electronic mailing lists, source code control systems,
58 | and issue tracking systems that are managed by, or on behalf of, the
59 | Licensor for the purpose of discussing and improving the Work, but
60 | excluding communication that is conspicuously marked or otherwise
61 | designated in writing by the copyright owner as "Not a Contribution."
62 |
63 | "Contributor" shall mean Licensor and any individual or Legal Entity
64 | on behalf of whom a Contribution has been received by Licensor and
65 | subsequently incorporated within the Work.
66 |
67 | 2. Grant of Copyright License. Subject to the terms and conditions of
68 | this License, each Contributor hereby grants to You a perpetual,
69 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
70 | copyright license to reproduce, prepare Derivative Works of,
71 | publicly display, publicly perform, sublicense, and distribute the
72 | Work and such Derivative Works in Source or Object form.
73 |
74 | 3. Grant of Patent License. Subject to the terms and conditions of
75 | this License, each Contributor hereby grants to You a perpetual,
76 | worldwide, non-exclusive, no-charge, royalty-free, irrevocable
77 | (except as stated in this section) patent license to make, have made,
78 | use, offer to sell, sell, import, and otherwise transfer the Work,
79 | where such license applies only to those patent claims licensable
80 | by such Contributor that are necessarily infringed by their
81 | Contribution(s) alone or by combination of their Contribution(s)
82 | with the Work to which such Contribution(s) was submitted. If You
83 | institute patent litigation against any entity (including a
84 | cross-claim or counterclaim in a lawsuit) alleging that the Work
85 | or a Contribution incorporated within the Work constitutes direct
86 | or contributory patent infringement, then any patent licenses
87 | granted to You under this License for that Work shall terminate
88 | as of the date such litigation is filed.
89 |
90 | 4. Redistribution. You may reproduce and distribute copies of the
91 | Work or Derivative Works thereof in any medium, with or without
92 | modifications, and in Source or Object form, provided that You
93 | meet the following conditions:
94 |
95 | (a) You must give any other recipients of the Work or
96 | Derivative Works a copy of this License; and
97 |
98 | (b) You must cause any modified files to carry prominent notices
99 | stating that You changed the files; and
100 |
101 | (c) You must retain, in the Source form of any Derivative Works
102 | that You distribute, all copyright, patent, trademark, and
103 | attribution notices from the Source form of the Work,
104 | excluding those notices that do not pertain to any part of
105 | the Derivative Works; and
106 |
107 | (d) If the Work includes a "NOTICE" text file as part of its
108 | distribution, then any Derivative Works that You distribute must
109 | include a readable copy of the attribution notices contained
110 | within such NOTICE file, excluding those notices that do not
111 | pertain to any part of the Derivative Works, in at least one
112 | of the following places: within a NOTICE text file distributed
113 | as part of the Derivative Works; within the Source form or
114 | documentation, if provided along with the Derivative Works; or,
115 | within a display generated by the Derivative Works, if and
116 | wherever such third-party notices normally appear. The contents
117 | of the NOTICE file are for informational purposes only and
118 | do not modify the License. You may add Your own attribution
119 | notices within Derivative Works that You distribute, alongside
120 | or as an addendum to the NOTICE text from the Work, provided
121 | that such additional attribution notices cannot be construed
122 | as modifying the License.
123 |
124 | You may add Your own copyright statement to Your modifications and
125 | may provide additional or different license terms and conditions
126 | for use, reproduction, or distribution of Your modifications, or
127 | for any such Derivative Works as a whole, provided Your use,
128 | reproduction, and distribution of the Work otherwise complies with
129 | the conditions stated in this License.
130 |
131 | 5. Submission of Contributions. Unless You explicitly state otherwise,
132 | any Contribution intentionally submitted for inclusion in the Work
133 | by You to the Licensor shall be under the terms and conditions of
134 | this License, without any additional terms or conditions.
135 | Notwithstanding the above, nothing herein shall supersede or modify
136 | the terms of any separate license agreement you may have executed
137 | with Licensor regarding such Contributions.
138 |
139 | 6. Trademarks. This License does not grant permission to use the trade
140 | names, trademarks, service marks, or product names of the Licensor,
141 | except as required for reasonable and customary use in describing the
142 | origin of the Work and reproducing the content of the NOTICE file.
143 |
144 | 7. Disclaimer of Warranty. Unless required by applicable law or
145 | agreed to in writing, Licensor provides the Work (and each
146 | Contributor provides its Contributions) on an "AS IS" BASIS,
147 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
148 | implied, including, without limitation, any warranties or conditions
149 | of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
150 | PARTICULAR PURPOSE. You are solely responsible for determining the
151 | appropriateness of using or redistributing the Work and assume any
152 | risks associated with Your exercise of permissions under this License.
153 |
154 | 8. Limitation of Liability. In no event and under no legal theory,
155 | whether in tort (including negligence), contract, or otherwise,
156 | unless required by applicable law (such as deliberate and grossly
157 | negligent acts) or agreed to in writing, shall any Contributor be
158 | liable to You for damages, including any direct, indirect, special,
159 | incidental, or consequential damages of any character arising as a
160 | result of this License or out of the use or inability to use the
161 | Work (including but not limited to damages for loss of goodwill,
162 | work stoppage, computer failure or malfunction, or any and all
163 | other commercial damages or losses), even if such Contributor
164 | has been advised of the possibility of such damages.
165 |
166 | 9. Accepting Warranty or Additional Liability. While redistributing
167 | the Work or Derivative Works thereof, You may choose to offer,
168 | and charge a fee for, acceptance of support, warranty, indemnity,
169 | or other liability obligations and/or rights consistent with this
170 | License. However, in accepting such obligations, You may act only
171 | on Your own behalf and on Your sole responsibility, not on behalf
172 | of any other Contributor, and only if You agree to indemnify,
173 | defend, and hold each Contributor harmless for any liability
174 | incurred by, or claims asserted against, such Contributor by reason
175 | of your accepting any such warranty or additional liability.
176 |
177 | END OF TERMS AND CONDITIONS
178 |
179 | APPENDIX: How to apply the Apache License to your work.
180 |
181 | To apply the Apache License to your work, attach the following
182 | boilerplate notice, with the fields enclosed by brackets "[]"
183 | replaced with your own identifying information. (Don't include
184 | the brackets!) The text should be enclosed in the appropriate
185 | comment syntax for the file format. We also recommend that a
186 | file or class name and description of purpose be included on the
187 | same "printed page" as the copyright notice for easier
188 | identification within third-party archives.
189 |
190 | Copyright 2018 Google Inc.
191 |
192 | Licensed under the Apache License, Version 2.0 (the "License");
193 | you may not use this file except in compliance with the License.
194 | You may obtain a copy of the License at
195 |
196 | http://www.apache.org/licenses/LICENSE-2.0
197 |
198 | Unless required by applicable law or agreed to in writing, software
199 | distributed under the License is distributed on an "AS IS" BASIS,
200 | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
201 | See the License for the specific language governing permissions and
202 | limitations under the License.
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | # ndb
2 |
3 |
4 | [](https://travis-ci.com/GoogleChromeLabs/ndb)
5 | [](https://npmjs.org/package/ndb)
6 |
7 |
8 | 
9 |
10 | > ndb is an improved debugging experience for Node.js, enabled by Chrome DevTools
11 |
12 | ## Installation
13 |
14 | Compatibility: ndb requires Node >=8.0.0. It works best with Node >=10.
15 |
16 | Installation: ndb depends on [Puppeteer](https://github.com/GoogleChrome/puppeteer) which downloads a recent version of Chromium (~170MB Mac, ~280MB Linux, ~280MB Win).
17 |
18 | ```bash
19 | # global install with npm:
20 | npm install -g ndb
21 |
22 |
23 | # alternatively, with yarn:
24 | yarn global add ndb
25 | ```
26 |
27 | Global installation may fail with different permission errors, you can find help in this [thread](https://github.com/GoogleChromeLabs/ndb/issues/20).
28 |
29 | Windows users: Installation may fail on Windows during compilation the native dependencies. The following command may help: `npm install -g windows-build-tools`
30 |
31 | ### Local install
32 |
33 | If you want ndb available from an npm script (eg. `npm run debug` runs `ndb index.js`), you can install it as a development dependency:
34 |
35 | ```bash
36 | # local install with npm:
37 | npm install --save-dev ndb
38 |
39 |
40 | # alternatively, with yarn:
41 | yarn add ndb --dev
42 | ```
43 |
44 | You can then [set up an npm script](https://docs.npmjs.com/misc/scripts#examples). In this case, ndb will not be available in your system path.
45 |
46 |
47 | ## Getting Started
48 |
49 | You can start debugging your Node.js application using one of the following ways:
50 |
51 | - Use `ndb` instead of the `node` command
52 |
53 | ```bash
54 | ndb server.js
55 |
56 | # Alternatively, you can prepend `ndb`
57 | ndb node server.js
58 | ```
59 |
60 | - Prepend `ndb` in front of any other binary
61 |
62 | ```bash
63 | # If you use some other binary, just prepend `ndb`
64 | ## npm run unit
65 | ndb npm run unit
66 |
67 | # Debug any globally installed package
68 | ## mocha
69 | ndb mocha
70 |
71 | # To use a local binary, use `npx` and prepend before it
72 | ndb npx mocha
73 | ```
74 |
75 | - Launch `ndb` as a standalone application
76 | - Then, debug any npm script from your `package.json`, e.g. unit tests
77 |
78 | ```bash
79 | # cd to your project folder (with a package.json)
80 | ndb .
81 | # In Sources panel > "NPM Scripts" sidebar, click the selected "Run" button
82 | ```
83 |
84 | - Use `Ctrl`/`Cmd` + `R` to restart last run
85 | - Run any node command from within ndb's integrated terminal and ndb will connect automatically
86 | - Run any open script source by using 'Run this script' context menu item, ndb will connect automatically as well
87 |
88 | - Use `--prof` flag to profile your app, `Ctrl`/`Cmd` + `R` restarts profiling
89 | ```bash
90 | ndb --prof npm run unit
91 | ```
92 |
93 | ## What can I do?
94 |
95 | `ndb` has some powerful features exclusively for Node.js:
96 | 1. Child processes are detected and attached to.
97 | 1. You can place breakpoints before the modules are required.
98 | 1. You can edit your files within the UI. On Ctrl-S/Cmd-S, DevTools will [save the changes to disk](https://developers.google.com/web/tools/chrome-devtools/workspaces/).
99 | 1. By default, ndb [blackboxes](https://developers.google.com/web/tools/chrome-devtools/javascript/reference#blackbox) all scripts outside current working directory to improve focus. This includes node internal libraries (like `_stream_wrap.js`, `async_hooks.js`, `fs.js`) This behaviour may be changed by "Blackbox anything outside working dir" setting.
100 |
101 | In addition, you can use all the DevTools functionality that you've used in [typical Node debugging](https://medium.com/@paul_irish/debugging-node-js-nightlies-with-chrome-devtools-7c4a1b95ae27):
102 | - breakpoint debugging, async stacks (AKA long stack traces), [async stepping](https://developers.google.com/web/updates/2018/01/devtools#async), etc...
103 | - console (top-level await, object inspection, advanced filtering)
104 | - [eager evaluation](https://developers.google.com/web/updates/2018/05/devtools#eagerevaluation) in console (requires Node >= 10)
105 | - JS sampling profiler
106 | - memory profiler
107 |
108 | ### Screenshot
109 | 
110 |
111 |
112 | ## Contributing
113 |
114 | Check out [contributing guide](https://github.com/GoogleChromeLabs/ndb/blob/master/CONTRIBUTING.md) to get an overview of ndb development.
115 |
116 | #### Thanks to the 'OG' `ndb`
117 |
118 | In early 2011, [@smtlaissezfaire](https://github.com/smtlaissezfaire) released the first serious debugger for Node.js, under the `ndb` package name. It's still preserved at [github.com/smtlaissezfaire/ndb](https://github.com/smtlaissezfaire/ndb#readme). We thank Scott for generously donating the package name.
119 |
--------------------------------------------------------------------------------
/build.js:
--------------------------------------------------------------------------------
1 | const path = require('path');
2 |
3 | const Terser = require('terser');
4 | const rimraf = require('rimraf');
5 |
6 | const { buildApp } = require('./scripts/builder.js');
7 |
8 | const DEVTOOLS_DIR = path.dirname(
9 | require.resolve('chrome-devtools-frontend/front_end/shell.json'));
10 |
11 | (async function main() {
12 | const outFolder = path.join(__dirname, '.local-frontend');
13 | await new Promise(resolve => rimraf(outFolder, resolve));
14 |
15 | return buildApp(
16 | ['ndb', 'heap_snapshot_worker', 'formatter_worker'], [
17 | path.join(__dirname, 'front_end'),
18 | DEVTOOLS_DIR,
19 | path.join(__dirname, 'node_modules'),
20 | ], outFolder,
21 | minifyJS);
22 | })();
23 |
24 | function minifyJS(code) {
25 | return Terser.minify(code, {
26 | mangle: true,
27 | ecma: 8,
28 | compress: false
29 | }).code;
30 | }
31 |
--------------------------------------------------------------------------------
/debug.js:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env node
2 | process.env.NDB_DEBUG_FRONTEND = 1;
3 | require('./ndb.js');
4 |
--------------------------------------------------------------------------------
/docs/issue_template.md:
--------------------------------------------------------------------------------
1 |
4 |
5 | ### Steps to reproduce
6 |
7 | **Tell us about your environment:**
8 |
9 | * ndb version:
10 | * Platform / OS version:
11 | * Node.js version:
12 |
13 | **What steps will reproduce the problem?**
14 |
15 | _Please include code that reproduces the issue._
16 |
17 | 1.
18 | 2.
19 | 3.
20 |
21 | **What is the expected result?**
22 |
23 |
24 | **What happens instead?**
25 |
--------------------------------------------------------------------------------
/front_end/favicon.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/GoogleChromeLabs/ndb/ade2052ad27f3c90cfd97c6aa87465c179572f8a/front_end/favicon.png
--------------------------------------------------------------------------------
/front_end/ndb.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
8 |
9 |
10 |
11 |
12 |
--------------------------------------------------------------------------------
/front_end/ndb.js:
--------------------------------------------------------------------------------
1 | // Copyright 2018 The Chromium Authors. All rights reserved.
2 | // Use of this source code is governed by a BSD-style license that can be
3 | // found in the LICENSE file.
4 |
5 | Runtime.startApplication('ndb');
6 |
--------------------------------------------------------------------------------
/front_end/ndb.json:
--------------------------------------------------------------------------------
1 | {
2 | "modules" : [
3 | { "name": "ndb_sdk", "type": "autostart" },
4 | { "name": "ndb", "type": "autostart" },
5 | { "name": "layer_viewer" },
6 | { "name": "timeline_model" },
7 | { "name": "timeline" },
8 | { "name": "product_registry" },
9 | { "name": "mobile_throttling" },
10 | { "name": "ndb_ui" },
11 | { "name": "xterm" }
12 | ],
13 | "extends": "shell",
14 | "has_html": true
15 | }
16 |
--------------------------------------------------------------------------------
/front_end/ndb/Connection.js:
--------------------------------------------------------------------------------
1 | Ndb.Connection = class {
2 | constructor(channel) {
3 | this._onMessage = null;
4 | this._onDisconnect = null;
5 | this._channel = channel;
6 | }
7 |
8 | static async create(channel) {
9 | const connection = new Ndb.Connection(channel);
10 | await channel.listen(rpc.handle(connection));
11 | return connection;
12 | }
13 |
14 | /**
15 | * @param {function((!Object|string))} onMessage
16 | */
17 | setOnMessage(onMessage) {
18 | this._onMessage = onMessage;
19 | }
20 |
21 | /**
22 | * @param {function(string)} onDisconnect
23 | */
24 | setOnDisconnect(onDisconnect) {
25 | this._onDisconnect = onDisconnect;
26 | }
27 |
28 | /**
29 | * @param {string} message
30 | */
31 | sendRawMessage(message) {
32 | this._channel.send(message);
33 | }
34 |
35 | /**
36 | * @return {!Promise}
37 | */
38 | disconnect() {
39 | this._channel.close();
40 | }
41 |
42 | /**
43 | * @param {message}
44 | */
45 | dispatchMessage(message) {
46 | if (this._onMessage)
47 | this._onMessage(message);
48 | }
49 | };
50 |
--------------------------------------------------------------------------------
/front_end/ndb/FileSystem.js:
--------------------------------------------------------------------------------
1 | /**
2 | * @license Copyright 2018 Google Inc. All Rights Reserved.
3 | * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
4 | * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
5 | */
6 |
7 | Ndb.FileSystem = class extends Persistence.PlatformFileSystem {
8 | constructor(fsService, fsIOService, searchService, manager, rootURL) {
9 | super(rootURL, '');
10 | this._fsService = fsService;
11 | this._fsIOService = fsIOService;
12 | this._searchService = searchService;
13 | this._rootURL = rootURL;
14 | this._manager = manager;
15 |
16 | /** @type {!Array} */
17 | this._initialFilePaths = [];
18 | }
19 |
20 | static async create(manager, rootURL) {
21 | const searchClient = new Ndb.FileSystem.SearchClient();
22 | const [fsService, fsIOService, searchService] = await Promise.all([
23 | Ndb.backend.createService('file_system.js'),
24 | Ndb.backend.createService('file_system_io.js'),
25 | Ndb.backend.createService('search.js', rpc.handle(searchClient))]);
26 |
27 | // TODO: fix PlatformFileSystem upstream, entire search / indexing pipeline should go
28 | // through the platform filesystem. This should make searchClient also go away.
29 | InspectorFrontendHost.stopIndexing = searchService.stopIndexing.bind(searchService);
30 |
31 | const fs = new Ndb.FileSystem(fsService, fsIOService, searchService, manager, rootURL);
32 | await fs._initFilePaths();
33 | return fs;
34 | }
35 |
36 | /**
37 | * @override
38 | * @return {string}
39 | */
40 | embedderPath() {
41 | throw new Error('Not implemented');
42 | }
43 |
44 | /**
45 | * @override
46 | * @return {!Promise}
47 | */
48 | async _initFilePaths() {
49 | await this._fsService.startWatcher(this._rootURL, this._excludePattern(), rpc.handle(this));
50 | }
51 |
52 | forceFileLoad(scriptName) {
53 | return this._fsService.forceFileLoad(scriptName);
54 | }
55 |
56 | /**
57 | * @override
58 | * @return {!Array}
59 | */
60 | initialFilePaths() {
61 | return this._initialFilePaths;
62 | }
63 |
64 | /**
65 | * @override
66 | * @return {!Array}
67 | */
68 | initialGitFolders() {
69 | return [];
70 | }
71 |
72 | /**
73 | * @override
74 | * @param {string} path
75 | * @return {!Promise}
76 | */
77 | getMetadata(path) {
78 | // This method should never be called as long as we are matching using file urls.
79 | throw new Error('not implemented');
80 | }
81 |
82 | /**
83 | * @override
84 | * @param {string} path
85 | * @return {!Promise}
86 | */
87 | requestFileBlob(path) {
88 | throw new Error('not implemented');
89 | }
90 |
91 | /**
92 | * @override
93 | * @param {string} path
94 | * @param {function(?string,boolean)} callback
95 | */
96 | async requestFileContent(path, callback) {
97 | const result = await this._fsIOService.readFile(this._rootURL + path, 'base64');
98 | if (this.contentType(path) === Common.resourceTypes.Image) {
99 | callback(result, true);
100 | } else {
101 | const content = await(await fetch(`data:application/octet-stream;base64,${result}`)).text();
102 | callback(content, false);
103 | }
104 | }
105 |
106 | /**
107 | * @override
108 | * @param {string} path
109 | * @param {string} content
110 | * @param {boolean} isBase64
111 | */
112 | async setFileContent(path, content, isBase64) {
113 | await this._fsIOService.writeFile(this._rootURL + path, isBase64 ? content : content.toBase64(), 'base64');
114 | }
115 |
116 | /**
117 | * @override
118 | * @param {string} path
119 | * @param {?string} name
120 | * @return {!Promise}
121 | */
122 | async createFile(path, name) {
123 | const result = await this._fsIOService.createFile(this._rootURL + (path.length === 0 || path.startsWith('/') ? '' : '/') + path);
124 | return result.substr(this._rootURL.length + 1);
125 | }
126 |
127 | /**
128 | * @override
129 | * @param {string} path
130 | * @return {!Promise}
131 | */
132 | async deleteFile(path) {
133 | return await this._fsIOService.deleteFile(this._rootURL + path);
134 | }
135 |
136 | /**
137 | * @override
138 | * @param {string} path
139 | * @param {string} newName
140 | * @param {function(boolean, string=)} callback
141 | */
142 | async renameFile(path, newName, callback) {
143 | const result = await this._fsIOService.renameFile(this._rootURL + path, newName);
144 | callback(result, result ? newName : null);
145 | }
146 |
147 | /**
148 | * @override
149 | * @param {string} path
150 | * @return {!Common.ResourceType}
151 | */
152 | contentType(path) {
153 | const extension = Common.ParsedURL.extractExtension(path);
154 | if (Persistence.IsolatedFileSystem._styleSheetExtensions.has(extension))
155 | return Common.resourceTypes.Stylesheet;
156 | if (Persistence.IsolatedFileSystem._documentExtensions.has(extension))
157 | return Common.resourceTypes.Document;
158 | if (Persistence.IsolatedFileSystem.ImageExtensions.has(extension))
159 | return Common.resourceTypes.Image;
160 | if (Persistence.IsolatedFileSystem._scriptExtensions.has(extension))
161 | return Common.resourceTypes.Script;
162 | return Persistence.IsolatedFileSystem.BinaryExtensions.has(extension) ? Common.resourceTypes.Other :
163 | Common.resourceTypes.Document;
164 | }
165 |
166 | /**
167 | * @override
168 | * @param {string} path
169 | * @return {string}
170 | */
171 | mimeFromPath(path) {
172 | return Common.ResourceType.mimeFromURL(path) || 'text/plain';
173 | }
174 |
175 | /**
176 | * @override
177 | * @param {string} path
178 | * @return {boolean}
179 | */
180 | canExcludeFolder(path) {
181 | return !!path ;
182 | }
183 |
184 | /**
185 | * @override
186 | * @param {string} url
187 | * @return {string}
188 | */
189 | tooltipForURL(url) {
190 | const path = Common.ParsedURL.urlToPlatformPath(url, Host.isWin()).trimMiddle(150);
191 | return ls`Linked to ${path}`;
192 | }
193 |
194 | /**
195 | * @override
196 | * @param {string} query
197 | * @param {!Common.Progress} progress
198 | * @return {!Promise>}
199 | */
200 | searchInPath(query, progress) {
201 | return new Promise(resolve => {
202 | const requestId = this._manager.registerCallback(innerCallback);
203 | this._searchService.searchInPath(requestId, this._rootURL, query);
204 |
205 | /**
206 | * @param {!Array} files
207 | */
208 | function innerCallback(files) {
209 | resolve(files);
210 | progress.worked(1);
211 | }
212 | });
213 | }
214 |
215 | /**
216 | * @param {string} name
217 | */
218 | filesChanged(events) {
219 | for (const event of events) {
220 | const paths = new Multimap();
221 | paths.set(this._rootURL, event.name);
222 | const emptyMap = new Multimap();
223 | Persistence.isolatedFileSystemManager.dispatchEventToListeners(Persistence.IsolatedFileSystemManager.Events.FileSystemFilesChanged, {
224 | changed: event.type === 'change' ? paths : emptyMap,
225 | added: event.type === 'add' ? paths : emptyMap,
226 | removed: event.type === 'unlink' ? paths : emptyMap
227 | });
228 | }
229 | }
230 |
231 | /**
232 | * @override
233 | * @param {!Common.Progress} progress
234 | */
235 | indexContent(progress) {
236 | progress.setTotalWork(1);
237 | const requestId = this._manager.registerProgress(progress);
238 | this._searchService.indexPath(requestId, this._rootURL, this._excludePattern());
239 | }
240 |
241 | /**
242 | * @override
243 | * @return {boolean}
244 | */
245 | supportsAutomapping() {
246 | return true;
247 | }
248 |
249 | /**
250 | * @return {string}
251 | */
252 | _excludePattern() {
253 | return this._manager.workspaceFolderExcludePatternSetting().get();
254 | }
255 | };
256 |
257 | Ndb.FileSystem.SearchClient = class {
258 | /**
259 | * @param {number} requestId
260 | * @param {string} fileSystemPath
261 | * @param {number} totalWork
262 | */
263 | indexingTotalWorkCalculated(requestId, fileSystemPath, totalWork) {
264 | this._callFrontend(() => InspectorFrontendAPI.indexingTotalWorkCalculated(requestId, fileSystemPath, totalWork));
265 | }
266 |
267 | /**
268 | * @param {number} requestId
269 | * @param {string} fileSystemPath
270 | * @param {number} worked
271 | */
272 | indexingWorked(requestId, fileSystemPath, worked) {
273 | this._callFrontend(() => InspectorFrontendAPI.indexingWorked(requestId, fileSystemPath, worked));
274 | }
275 |
276 | /**
277 | * @param {number} requestId
278 | * @param {string} fileSystemPath
279 | */
280 | indexingDone(requestId, fileSystemPath) {
281 | this._callFrontend(_ => InspectorFrontendAPI.indexingDone(requestId, fileSystemPath));
282 | }
283 |
284 | /**
285 | * @param {number} requestId
286 | * @param {string} fileSystemPath
287 | * @param {!Array.} files
288 | */
289 | searchCompleted(requestId, fileSystemPath, files) {
290 | this._callFrontend(_ => InspectorFrontendAPI.searchCompleted(requestId, fileSystemPath, files));
291 | }
292 |
293 | _callFrontend(f) {
294 | if (Runtime.queryParam('debugFrontend'))
295 | setTimeout(f, 0);
296 | else
297 | f();
298 | }
299 | };
300 |
--------------------------------------------------------------------------------
/front_end/ndb/InspectorFrontendHostOverrides.js:
--------------------------------------------------------------------------------
1 | /**
2 | * @license Copyright 2018 Google Inc. All Rights Reserved.
3 | * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
4 | * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
5 | */
6 |
7 | (function(){
8 | InspectorFrontendHost.getPreferences = async function(callback) {
9 | [Ndb.backend] = await carlo.loadParams();
10 | const prefs = {
11 | '__bundled__uiTheme': '"dark"'
12 | };
13 | for (let i = 0; i < window.localStorage.length; i++) {
14 | const key = window.localStorage.key(i);
15 | prefs[key] = window.localStorage.getItem(key);
16 | }
17 | callback(prefs);
18 | };
19 |
20 | InspectorFrontendHost.isHostedMode = () => false;
21 | InspectorFrontendHost.copyText = text => navigator.clipboard.writeText(text);
22 | InspectorFrontendHost.openInNewTab = url => Ndb.backend.openInNewTab(url);
23 | InspectorFrontendHost.bringToFront = () => Ndb.backend.bringToFront();
24 | InspectorFrontendHost.loadNetworkResource = async(url, headers, streamId, callback) => {
25 | const text = await Ndb.backend.loadNetworkResource(url, headers);
26 | if (text) {
27 | Host.ResourceLoader.streamWrite(streamId, text);
28 | callback({statusCode: 200});
29 | } else {
30 | callback({statusCode: 404});
31 | }
32 | };
33 | })();
34 |
--------------------------------------------------------------------------------
/front_end/ndb/NdbMain.js:
--------------------------------------------------------------------------------
1 | /**
2 | * @license Copyright 2018 Google Inc. All Rights Reserved.
3 | * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
4 | * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
5 | */
6 |
7 | Ndb.npmExecPath = function() {
8 | if (!Ndb._npmExecPathPromise)
9 | Ndb._npmExecPathPromise = Ndb.backend.which('npm').then(result => result.resolvedPath);
10 | return Ndb._npmExecPathPromise;
11 | };
12 |
13 | /**
14 | * @implements {Common.Runnable}
15 | */
16 | Ndb.NdbMain = class extends Common.Object {
17 | /**
18 | * @override
19 | */
20 | async run() {
21 | InspectorFrontendAPI.setUseSoftMenu(true);
22 | document.title = 'ndb';
23 | Common.moduleSetting('blackboxInternalScripts').addChangeListener(Ndb.NdbMain._calculateBlackboxState);
24 | Ndb.NdbMain._calculateBlackboxState();
25 |
26 | const setting = Persistence.isolatedFileSystemManager.workspaceFolderExcludePatternSetting();
27 | setting.set(Ndb.NdbMain._defaultExcludePattern().join('|'));
28 | Ndb.nodeProcessManager = await Ndb.NodeProcessManager.create(SDK.targetManager);
29 |
30 | Ndb.processInfo = await Ndb.backend.processInfo();
31 | await Ndb.nodeProcessManager.addFileSystem(Ndb.processInfo.cwd);
32 |
33 | // TODO(ak239): we do not want to create this model for workers, so we need a way to add custom capabilities.
34 | SDK.SDKModel.register(NdbSdk.NodeWorkerModel, SDK.Target.Capability.JS, true);
35 | SDK.SDKModel.register(NdbSdk.NodeRuntimeModel, SDK.Target.Capability.JS, true);
36 |
37 | await new Promise(resolve => SDK.initMainConnection(resolve));
38 | SDK.targetManager.createTarget('', ls`Root`, SDK.Target.Type.Browser, null);
39 | if (Common.moduleSetting('autoStartMain').get()) {
40 | const main = await Ndb.mainConfiguration();
41 | if (main) {
42 | if (main.prof)
43 | await Ndb.nodeProcessManager.profile(main.execPath, main.args);
44 | else
45 | Ndb.nodeProcessManager.debug(main.execPath, main.args);
46 | }
47 | }
48 | Ndb.nodeProcessManager.startRepl();
49 | }
50 |
51 | static _defaultExcludePattern() {
52 | const defaultCommonExcludedFolders = [
53 | '/bower_components/', '/\\.devtools', '/\\.git/', '/\\.sass-cache/', '/\\.hg/', '/\\.idea/',
54 | '/\\.svn/', '/\\.cache/', '/\\.project/'
55 | ];
56 | const defaultWinExcludedFolders = ['/Thumbs.db$', '/ehthumbs.db$', '/Desktop.ini$', '/\\$RECYCLE.BIN/'];
57 | const defaultMacExcludedFolders = [
58 | '/\\.DS_Store$', '/\\.Trashes$', '/\\.Spotlight-V100$', '/\\.AppleDouble$', '/\\.LSOverride$', '/Icon$',
59 | '/\\._.*$'
60 | ];
61 | const defaultLinuxExcludedFolders = ['/.*~$'];
62 | let defaultExcludedFolders = defaultCommonExcludedFolders;
63 | if (Host.isWin())
64 | defaultExcludedFolders = defaultExcludedFolders.concat(defaultWinExcludedFolders);
65 | else if (Host.isMac())
66 | defaultExcludedFolders = defaultExcludedFolders.concat(defaultMacExcludedFolders);
67 | else
68 | defaultExcludedFolders = defaultExcludedFolders.concat(defaultLinuxExcludedFolders);
69 | return defaultExcludedFolders;
70 | }
71 |
72 | static _calculateBlackboxState() {
73 | const blackboxInternalScripts = Common.moduleSetting('blackboxInternalScripts').get();
74 | const PATTERN = '^internal[\\/].*|bin/npm-cli\.js$|bin/yarn\.js$';
75 | const regexPatterns = Common.moduleSetting('skipStackFramesPattern').getAsArray()
76 | .filter(({pattern}) => pattern !== PATTERN && pattern !== '^internal/.*');
77 | if (blackboxInternalScripts)
78 | regexPatterns.push({pattern: PATTERN });
79 | Common.moduleSetting('skipStackFramesPattern').setAsArray(regexPatterns);
80 | }
81 | };
82 |
83 | Ndb.mainConfiguration = async() => {
84 | const info = Ndb.processInfo;
85 | const cmd = info.argv.slice(2);
86 | if (cmd.length === 0 || cmd[0] === '.')
87 | return null;
88 | let execPath;
89 | let args;
90 | let prof = false;
91 | if (cmd[0] === '--prof') {
92 | prof = true;
93 | cmd.shift();
94 | }
95 | if (cmd[0].endsWith('.js')
96 | || cmd[0].endsWith('.mjs')
97 | || cmd[0].startsWith('-')) {
98 | execPath = await Ndb.processInfo.nodeExecPath;
99 | args = cmd;
100 | } else {
101 | execPath = cmd[0];
102 | args = cmd.slice(1);
103 | }
104 | if (execPath === 'npm')
105 | execPath = await Ndb.npmExecPath();
106 | else if (execPath === 'node')
107 | execPath = await Ndb.processInfo.nodeExecPath;
108 | return {
109 | name: 'main',
110 | command: cmd.join(' '),
111 | execPath,
112 | args,
113 | prof
114 | };
115 | };
116 |
117 | /**
118 | * @implements {UI.ContextMenu.Provider}
119 | * @unrestricted
120 | */
121 | Ndb.ContextMenuProvider = class {
122 | /**
123 | * @override
124 | * @param {!Event} event
125 | * @param {!UI.ContextMenu} contextMenu
126 | * @param {!Object} object
127 | */
128 | appendApplicableItems(event, contextMenu, object) {
129 | if (!(object instanceof Workspace.UISourceCode))
130 | return;
131 | const url = object.url();
132 | if (!url.startsWith('file://') || (!url.endsWith('.js') && !url.endsWith('.mjs')))
133 | return;
134 | contextMenu.debugSection().appendItem(ls`Run this script`, async() => {
135 | const platformPath = await Ndb.backend.fileURLToPath(url);
136 | const args = url.endsWith('.mjs') ? ['--experimental-modules', platformPath] : [platformPath];
137 | Ndb.nodeProcessManager.debug(Ndb.processInfo.nodeExecPath, args);
138 | });
139 | }
140 | };
141 |
142 | Ndb._connectionSymbol = Symbol('connection');
143 |
144 | Ndb.NodeProcessManager = class extends Common.Object {
145 | constructor(targetManager) {
146 | super();
147 | this._service = null;
148 | this._lastDebugId = 0;
149 | this._lastStarted = null;
150 | this._targetManager = targetManager;
151 | this._cwds = new Map();
152 | this._finishProfiling = null;
153 | this._cpuProfiles = [];
154 | this._targetManager.addModelListener(
155 | SDK.RuntimeModel, SDK.RuntimeModel.Events.ExecutionContextDestroyed, this._onExecutionContextDestroyed, this);
156 | this._targetManager.addModelListener(
157 | NdbSdk.NodeRuntimeModel, NdbSdk.NodeRuntimeModel.Events.WaitingForDisconnect, this._onWaitingForDisconnect, this);
158 | }
159 |
160 | static async create(targetManager) {
161 | const manager = new Ndb.NodeProcessManager(targetManager);
162 | manager._service = await Ndb.backend.createService('ndd_service.js', rpc.handle(manager));
163 | return manager;
164 | }
165 |
166 | env() {
167 | return this._service.env();
168 | }
169 |
170 | /**
171 | * @param {string} cwd
172 | * @param {string=} mainFileName
173 | * @return {!Promise}
174 | */
175 | async addFileSystem(cwd, mainFileName) {
176 | let promise = this._cwds.get(cwd);
177 | if (!promise) {
178 | async function innerAdd() {
179 | const fileSystemManager = Persistence.isolatedFileSystemManager;
180 | const fs = await Ndb.FileSystem.create(fileSystemManager, cwd);
181 | fileSystemManager.addPlatformFileSystem(cwd, fs);
182 | return fs;
183 | }
184 | promise = innerAdd();
185 | this._cwds.set(cwd, promise);
186 | }
187 | if (mainFileName)
188 | await (await promise).forceFileLoad(mainFileName);
189 | await promise;
190 | }
191 |
192 | async detected(info, channel) {
193 | const connection = await Ndb.Connection.create(channel);
194 | const target = this._targetManager.createTarget(
195 | info.id, userFriendlyName(info), SDK.Target.Type.Node,
196 | this._targetManager.targetById(info.ppid) || this._targetManager.mainTarget(), undefined, false, connection);
197 | target[NdbSdk.connectionSymbol] = connection;
198 | await this.addFileSystem(info.cwd, info.scriptName);
199 | if (info.scriptName) {
200 | const scriptURL = info.scriptName;
201 | const uiSourceCode = Workspace.workspace.uiSourceCodeForURL(scriptURL);
202 | const isBlackboxed = Bindings.blackboxManager.isBlackboxedURL(scriptURL, false);
203 | if (isBlackboxed)
204 | return connection.disconnect();
205 | if (uiSourceCode) {
206 | if (Common.moduleSetting('pauseAtStart').get() && !isBlackboxed)
207 | Bindings.breakpointManager.setBreakpoint(uiSourceCode, 0, 0, '', true);
208 | else
209 | Common.Revealer.reveal(uiSourceCode);
210 | }
211 | }
212 | if (info.data === this._profilingNddData)
213 | this._profiling.add(target.id());
214 |
215 | function userFriendlyName(info) {
216 | if (info.data === 'ndb/repl')
217 | return 'repl';
218 | return info.argv.map(arg => {
219 | const index1 = arg.lastIndexOf('/');
220 | const index2 = arg.lastIndexOf('\\');
221 | if (index1 === -1 && index2 === -1)
222 | return arg;
223 | return arg.slice(Math.max(index1, index2) + 1);
224 | }).join(' ');
225 | }
226 | }
227 |
228 | disconnected(sessionId) {
229 | const target = this._targetManager.targetById(sessionId);
230 | if (target) {
231 | this._targetManager.removeTarget(target);
232 | target.dispose();
233 | }
234 | }
235 |
236 | async terminalData(stream, data) {
237 | const content = await(await fetch(`data:application/octet-stream;base64,${data}`)).text();
238 | if (content.startsWith('Debugger listening on') || content.startsWith('Debugger attached.') || content.startsWith('Waiting for the debugger to disconnect...'))
239 | return;
240 | await Ndb.backend.writeTerminalData(stream, data);
241 | this.dispatchEventToListeners(Ndb.NodeProcessManager.Events.TerminalData, content);
242 | }
243 |
244 | async _onExecutionContextDestroyed(event) {
245 | const executionContext = event.data;
246 | if (!executionContext.isDefault)
247 | return;
248 | return this._onWaitingForDisconnect({data: executionContext.target()});
249 | }
250 |
251 | async _onWaitingForDisconnect(event) {
252 | const target = event.data;
253 | if (target.name() === 'repl')
254 | this.startRepl();
255 | if (this._profiling && (this._profiling.has(target.id()) || this._profiling.has(target.parentTarget().id()))) {
256 | this._cpuProfiles.push({
257 | profile: await target.model(SDK.CPUProfilerModel).stopRecording(),
258 | name: target.name(),
259 | id: target.id()
260 | });
261 | this._profiling.delete(target.id());
262 | if (this._profiling.size === 0)
263 | this._finishProfiling();
264 | }
265 | const connection = target[NdbSdk.connectionSymbol];
266 | if (connection)
267 | await connection.disconnect();
268 | }
269 |
270 | async startRepl() {
271 | const code = btoa(`console.log('Welcome to the ndb %cR%cE%cP%cL%c!',
272 | 'color:#8bc34a', 'color:#ffc107', 'color:#ff5722', 'color:#2196f3', 'color:inherit');
273 | process.title = 'ndb/repl';
274 | process.on('uncaughtException', console.error);
275 | setInterval(_ => 0, 2147483647)//# sourceURL=repl.js`);
276 | const args = ['-e', `eval(Buffer.from('${code}', 'base64').toString())`];
277 | const options = { ignoreOutput: true, data: 'ndb/repl' };
278 | const node = Ndb.processInfo.nodeExecPath;
279 | return this.debug(node, args, options);
280 | }
281 |
282 | async debug(execPath, args, options) {
283 | options = options || {};
284 | const debugId = options.data || String(++this._lastDebugId);
285 | if (!options.data)
286 | this._lastStarted = {execPath, args, debugId, isProfiling: !!this._finishProfiling};
287 |
288 | return this._service.debug(
289 | execPath, args, {
290 | ...options,
291 | data: debugId,
292 | cwd: Ndb.processInfo.cwd
293 | });
294 | }
295 |
296 | async profile(execPath, args, options) {
297 | // TODO(ak239): move it out here.
298 | await UI.viewManager.showView('timeline');
299 | const action = UI.actionRegistry.action('timeline.toggle-recording');
300 | await action.execute();
301 | this._profilingNddData = String(++this._lastDebugId);
302 | this._profiling = new Set();
303 | this.debug(execPath, args, { data: this._profilingNddData });
304 | await new Promise(resolve => this._finishProfiling = resolve);
305 | this._profilingNddData = '';
306 | await Promise.all(SDK.targetManager.models(SDK.CPUProfilerModel).map(profiler => profiler.stopRecording()));
307 | const controller = Timeline.TimelinePanel.instance()._controller;
308 | const mainProfile = this._cpuProfiles.find(data => !data.id.includes('#'));
309 | controller.traceEventsCollected([{
310 | cat: SDK.TracingModel.DevToolsMetadataEventCategory,
311 | name: TimelineModel.TimelineModel.DevToolsMetadataEvent.TracingStartedInPage,
312 | ph: 'M', pid: 1, tid: mainProfile.id, ts: 0,
313 | args: {data: {sessionId: 1}}
314 | }]);
315 | for (const {profile, name, id} of this._cpuProfiles) {
316 | controller.traceEventsCollected([{
317 | cat: SDK.TracingModel.DevToolsMetadataEventCategory,
318 | name: TimelineModel.TimelineModel.DevToolsMetadataEvent.TracingSessionIdForWorker,
319 | ph: 'M', pid: 1, tid: id, ts: 0,
320 | args: {data: {sessionId: 1, workerThreadId: id, workerId: id, url: name}}
321 | }]);
322 | controller.traceEventsCollected(TimelineModel.TimelineJSProfileProcessor.buildTraceProfileFromCpuProfile(
323 | profile, id, false, TimelineModel.TimelineModel.WorkerThreadName));
324 | }
325 | this._cpuProfiles = [];
326 | await action.execute();
327 | }
328 |
329 | async kill(target) {
330 | return target.runtimeAgent().invoke_evaluate({
331 | expression: 'process.exit(-1)'
332 | });
333 | }
334 |
335 | async restartLast() {
336 | if (!this._lastStarted)
337 | return;
338 | await Promise.all(SDK.targetManager.targets()
339 | .filter(target => target.id() !== '')
340 | .map(target => target.runtimeAgent().invoke_evaluate({
341 | expression: `'${this._lastStarted.debugId}' === process.env.NDD_DATA && process.exit(-1)`
342 | })));
343 | const {execPath, args, isProfiling} = this._lastStarted;
344 | if (!isProfiling)
345 | await this.debug(execPath, args);
346 | else
347 | await this.profile(execPath, args);
348 | }
349 | };
350 |
351 | Ndb.NodeProcessManager.Events = {
352 | TerminalData: Symbol('terminalData')
353 | };
354 |
355 | /**
356 | * @implements {UI.ActionDelegate}
357 | * @unrestricted
358 | */
359 | Ndb.RestartActionDelegate = class {
360 | /**
361 | * @override
362 | * @param {!UI.Context} context
363 | * @param {string} actionId
364 | * @return {boolean}
365 | */
366 | handleAction(context, actionId) {
367 | switch (actionId) {
368 | case 'ndb.restart':
369 | Ndb.nodeProcessManager.restartLast();
370 | return true;
371 | }
372 | return false;
373 | }
374 | };
375 |
376 | // Temporary hack until frontend with fix is rolled.
377 | // fix: TBA.
378 | SDK.Target.prototype.decorateLabel = function(label) {
379 | return this.name();
380 | };
381 |
382 | // Front-end does not respect modern toggle semantics, patch it.
383 | const originalToggle = DOMTokenList.prototype.toggle;
384 | DOMTokenList.prototype.toggle = function(token, force) {
385 | if (arguments.length === 1)
386 | force = !this.contains(token);
387 | return originalToggle.call(this, token, !!force);
388 | };
389 |
390 | /**
391 | * @param {string} sourceMapURL
392 | * @param {string} compiledURL
393 | * @return {!Promise}
394 | * @this {SDK.TextSourceMap}
395 | */
396 | SDK.TextSourceMap.load = async function(sourceMapURL, compiledURL) {
397 | const {payload, error} = await Ndb.backend.loadSourceMap(sourceMapURL, compiledURL);
398 | if (error || !payload)
399 | return null;
400 |
401 | let textSourceMap;
402 | try {
403 | textSourceMap = new SDK.TextSourceMap(compiledURL, sourceMapURL, payload);
404 | } catch (e) {
405 | Common.console.warn('DevTools failed to parse SourceMap: ' + sourceMapURL);
406 | return null;
407 | }
408 |
409 | const modulePrefix = await Ndb.backend.getNodeScriptPrefix();
410 | for (const uiSourceCode of Workspace.workspace.uiSourceCodes()) {
411 | if (uiSourceCode.url() === compiledURL && uiSourceCode.project().type() === Workspace.projectTypes.Network) {
412 | const content = await uiSourceCode.requestContent();
413 | if (content.startsWith(modulePrefix)) {
414 | for (const mapping of textSourceMap.mappings()) {
415 | if (!mapping.lineNumber)
416 | mapping.columnNumber += modulePrefix.length;
417 | }
418 | break;
419 | }
420 | }
421 | }
422 |
423 | return textSourceMap;
424 | };
425 |
--------------------------------------------------------------------------------
/front_end/ndb/module.json:
--------------------------------------------------------------------------------
1 | {
2 | "extensions": [
3 | {
4 | "type": "early-initialization",
5 | "className": "Ndb.NdbMain"
6 | },
7 | {
8 | "type": "setting",
9 | "category": "Debugger",
10 | "title": "Set breakpoint at first line",
11 | "settingName": "pauseAtStart",
12 | "settingType": "boolean",
13 | "defaultValue": false
14 | },
15 | {
16 | "type": "setting",
17 | "category": "Debugger",
18 | "title": "Autostart main",
19 | "settingName": "autoStartMain",
20 | "settingType": "boolean",
21 | "defaultValue": true
22 | },
23 | {
24 | "type": "setting",
25 | "category": "Debugger",
26 | "title": "Blackbox internal/* Node.js scripts",
27 | "settingName": "blackboxInternalScripts",
28 | "settingType": "boolean",
29 | "defaultValue": true
30 | },
31 | {
32 | "type": "action",
33 | "actionId": "ndb.restart",
34 | "className": "Ndb.RestartActionDelegate",
35 | "title": "Restart last run configuration",
36 | "bindings": [
37 | {
38 | "platform": "windows,linux",
39 | "shortcut": "F5 Ctrl+R"
40 | },
41 | {
42 | "platform": "mac",
43 | "shortcut": "Meta+R"
44 | }
45 | ]
46 | },
47 | {
48 | "type": "@UI.ContextMenu.Provider",
49 | "contextTypes": [
50 | "Workspace.UISourceCode"
51 | ],
52 | "className": "Ndb.ContextMenuProvider"
53 | }
54 | ],
55 | "dependencies": ["common", "sdk", "ndb_sdk", "bindings", "persistence", "components"],
56 | "scripts": [
57 | "InspectorFrontendHostOverrides.js",
58 | "Connection.js",
59 | "FileSystem.js",
60 | "NdbMain.js"
61 | ]
62 | }
63 |
--------------------------------------------------------------------------------
/front_end/ndb_sdk/NodeRuntime.js:
--------------------------------------------------------------------------------
1 | Protocol.inspectorBackend.registerCommand('NodeRuntime.notifyWhenWaitingForDisconnect', [{'name': 'enabled', 'type': 'boolean', 'optional': false}], [], false);
2 | Protocol.inspectorBackend.registerEvent('NodeRuntime.waitingForDisconnect', []);
3 |
4 | NdbSdk.NodeRuntimeModel = class extends SDK.SDKModel {
5 | /**
6 | * @param {!SDK.Target} target
7 | */
8 | constructor(target) {
9 | super(target);
10 |
11 | this._agent = target.nodeRuntimeAgent();
12 | this.target().registerNodeRuntimeDispatcher(new NdbSdk.NodeRuntimeDispatcher(this));
13 | this._agent.notifyWhenWaitingForDisconnect(true);
14 | }
15 |
16 | /**
17 | * @param {string} sessionId
18 | * @param {!Object} workerInfo
19 | * @param {boolean} waitingForDebugger
20 | */
21 | _waitingForDisconnect() {
22 | this.dispatchEventToListeners(NdbSdk.NodeRuntimeModel.Events.WaitingForDisconnect, this.target());
23 | }
24 | };
25 |
26 | /** @enum {symbol} */
27 | NdbSdk.NodeRuntimeModel.Events = {
28 | WaitingForDisconnect: Symbol('WaitingForDisconnect')
29 | };
30 |
31 | NdbSdk.NodeRuntimeDispatcher = class {
32 | constructor(nodeRuntimeModel) {
33 | this._nodeRuntimeModel = nodeRuntimeModel;
34 | }
35 |
36 | waitingForDisconnect() {
37 | this._nodeRuntimeModel._waitingForDisconnect();
38 | }
39 | };
40 |
--------------------------------------------------------------------------------
/front_end/ndb_sdk/NodeWorker.js:
--------------------------------------------------------------------------------
1 | Protocol.inspectorBackend.registerCommand('NodeWorker.enable', [{'name': 'waitForDebuggerOnStart', 'type': 'boolean', 'optional': false}], [], false);
2 | Protocol.inspectorBackend.registerCommand('NodeWorker.disable', [], [], false);
3 | Protocol.inspectorBackend.registerCommand('NodeWorker.sendMessageToWorker', [{'name': 'message', 'type': 'string', 'optional': false}, {'name': 'sessionId', 'type': 'string', 'optional': false}], [], false);
4 | Protocol.inspectorBackend.registerCommand('NodeWorker.detach', [{'name': 'sessionId', 'type': 'string', 'optional': false}], [], false);
5 | Protocol.inspectorBackend.registerEvent('NodeWorker.attachedToWorker', ['sessionId', 'workerInfo', 'waitingForDebugger']);
6 | Protocol.inspectorBackend.registerEvent('NodeWorker.detachedFromWorker', ['sessionId']);
7 | Protocol.inspectorBackend.registerEvent('NodeWorker.receivedMessageFromWorker', ['sessionId', 'message']);
8 |
9 | NdbSdk.connectionSymbol = Symbol('connection');
10 |
11 | NdbSdk.NodeWorkerModel = class extends SDK.SDKModel {
12 | /**
13 | * @param {!SDK.Target} target
14 | */
15 | constructor(target) {
16 | super(target);
17 |
18 | this._sessions = new Map();
19 | this._targets = new Map();
20 | this._agent = target.nodeWorkerAgent();
21 | this.target().registerNodeWorkerDispatcher(new NdbSdk.NodeWorkerDispatcher(this));
22 | this._agent.invoke_enable({waitForDebuggerOnStart: true});
23 | }
24 |
25 | /**
26 | * @param {string} message
27 | * @param {string} sessionId
28 | * @return {!Promise}
29 | */
30 | sendMessageToWorker(message, sessionId) {
31 | return this._agent.sendMessageToWorker(message, sessionId);
32 | }
33 |
34 | /**
35 | * @param {string} sessionId
36 | * @return {!Promise}
37 | */
38 | detach(sessionId) {
39 | return this._agent.detach(sessionId);
40 | }
41 |
42 | /**
43 | * @override
44 | */
45 | dispose() {
46 | this._sessions.clear();
47 | for (const target of this._targets.values()) {
48 | SDK.targetManager.removeTarget(target);
49 | target.dispose();
50 | }
51 | this._targets.clear();
52 | }
53 |
54 | /**
55 | * @param {string} sessionId
56 | * @param {!Object} workerInfo
57 | * @param {boolean} waitingForDebugger
58 | */
59 | _attachedToWorker(sessionId, workerInfo, waitingForDebugger) {
60 | const id = this.target().id() + '#' + workerInfo.workerId;
61 | const connection = new NdbSdk.NodeWorkerConnection(sessionId, this);
62 | this._sessions.set(sessionId, connection);
63 | const target = SDK.targetManager.createTarget(
64 | id, workerInfo.title, SDK.Target.Type.Node, this.target(),
65 | undefined, false, connection);
66 | target[NdbSdk.connectionSymbol] = connection;
67 | this._targets.set(sessionId, target);
68 | target.runtimeAgent().runIfWaitingForDebugger();
69 | }
70 |
71 | /**
72 | * @param {string} sessionId
73 | */
74 | _detachedFromWorker(sessionId) {
75 | const session = this._sessions.get(sessionId);
76 | if (session) {
77 | this._sessions.delete(sessionId);
78 | const target = this._targets.get(sessionId);
79 | if (target) {
80 | SDK.targetManager.removeTarget(target);
81 | target.dispose();
82 | this._targets.delete(sessionId);
83 | }
84 | }
85 | }
86 |
87 | /**
88 | * @param {string} sessionId
89 | * @param {string} message
90 | */
91 | _receivedMessageFromWorker(sessionId, message) {
92 | const session = this._sessions.get(sessionId);
93 | if (session)
94 | session.receivedMessageFromWorker(message);
95 | }
96 | };
97 |
98 | NdbSdk.NodeWorkerConnection = class {
99 | constructor(sessionId, nodeWorkerModel) {
100 | this._onMessage = null;
101 | this._onDisconnect = null;
102 | this._sessionId = sessionId;
103 | this._nodeWorkerModel = nodeWorkerModel;
104 | }
105 |
106 | /**
107 | * @param {function((!Object|string))} onMessage
108 | */
109 | setOnMessage(onMessage) {
110 | this._onMessage = onMessage;
111 | }
112 |
113 | /**
114 | * @param {function(string)} onDisconnect
115 | */
116 | setOnDisconnect(onDisconnect) {
117 | this._onDisconnect = onDisconnect;
118 | }
119 |
120 | /**
121 | * @param {string} message
122 | */
123 | sendRawMessage(message) {
124 | this._nodeWorkerModel.sendMessageToWorker(message, this._sessionId);
125 | }
126 |
127 | /**
128 | * @return {!Promise}
129 | */
130 | disconnect() {
131 | return this._nodeWorkerModel.detach(this._sessionId);
132 | }
133 |
134 | /**
135 | * @param {string} message
136 | */
137 | receivedMessageFromWorker(message) {
138 | if (this._onMessage)
139 | this._onMessage(message);
140 | }
141 |
142 | detachedFromWorker() {
143 | if (this._onDisconnect)
144 | this._onDisconnect();
145 | }
146 | };
147 |
148 | NdbSdk.NodeWorkerDispatcher = class {
149 | /**
150 | * @param {!NdbSdk.NodeWorkerModel}
151 | */
152 | constructor(nodeWorkerModel) {
153 | this._nodeWorkerModel = nodeWorkerModel;
154 | }
155 |
156 | /**
157 | * @param {string} sessionId
158 | * @param {!Object} workerInfo
159 | * @param {boolean} waitingForDebugger
160 | */
161 | attachedToWorker(sessionId, workerInfo, waitingForDebugger) {
162 | this._nodeWorkerModel._attachedToWorker(sessionId, workerInfo, waitingForDebugger);
163 | }
164 |
165 | /**
166 | * @param {string} sessionId
167 | */
168 | detachedFromWorker(sessionId) {
169 | this._nodeWorkerModel._detachedFromWorker(sessionId);
170 | }
171 |
172 | /**
173 | * @param {string} sessionId
174 | * @param {string} message
175 | */
176 | receivedMessageFromWorker(sessionId, message) {
177 | this._nodeWorkerModel._receivedMessageFromWorker(sessionId, message);
178 | }
179 | };
180 |
--------------------------------------------------------------------------------
/front_end/ndb_sdk/module.json:
--------------------------------------------------------------------------------
1 | {
2 | "dependencies": ["sdk"],
3 | "scripts": [
4 | "NodeRuntime.js",
5 | "NodeWorker.js"
6 | ]
7 | }
8 |
--------------------------------------------------------------------------------
/front_end/ndb_ui/NodeProcesses.js:
--------------------------------------------------------------------------------
1 | /**
2 | * @license Copyright 2018 Google Inc. All Rights Reserved.
3 | * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
4 | * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
5 | */
6 |
7 | Ndb.NodeProcesses = class extends UI.VBox {
8 | constructor() {
9 | super(true);
10 | this.registerRequiredCSS('ndb_ui/nodeProcesses.css');
11 |
12 | const toolbar = new UI.Toolbar('process-toolbar', this.contentElement);
13 | this._pauseAtStartCheckbox = new UI.ToolbarSettingCheckbox(
14 | Common.moduleSetting('pauseAtStart'));
15 | this._pauseAtStartCheckbox.element.id = 'pause-at-start-checkbox';
16 | toolbar.appendToolbarItem(this._pauseAtStartCheckbox);
17 |
18 | this._emptyElement = this.contentElement.createChild('div', 'gray-info-message');
19 | this._emptyElement.id = 'no-running-nodes-msg';
20 | this._emptyElement.textContent = Common.UIString('No running nodes');
21 |
22 | this._treeOutline = new UI.TreeOutlineInShadow();
23 | this._treeOutline.registerRequiredCSS('ndb_ui/nodeProcesses.css');
24 | this.contentElement.appendChild(this._treeOutline.element);
25 | this._treeOutline.element.classList.add('hidden');
26 |
27 | this._targetToUI = new Map();
28 | SDK.targetManager.observeTargets(this);
29 | }
30 |
31 | /**
32 | * @override
33 | * @param {!SDK.Target} target
34 | */
35 | targetAdded(target) {
36 | if (target.id() === '')
37 | return;
38 | if (target.name() === 'repl')
39 | return;
40 | const f = UI.Fragment.build`
41 |
42 |
${target.name()}
43 |
44 |
41 |
42 |
${item.name}
43 |
${item.command}
44 |
45 |
49 |