playwright 1.56.0-alpha-2025-09-03 → 1.56.0-alpha-1756945786000
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/ThirdPartyNotices.txt +3 -3
- package/lib/index.js +2 -2
- package/lib/matchers/toBeTruthy.js +3 -3
- package/lib/matchers/toEqual.js +3 -3
- package/lib/matchers/toMatchText.js +3 -3
- package/lib/mcp/browser/actions.d.js +16 -0
- package/lib/mcp/browser/browserContextFactory.js +227 -0
- package/lib/mcp/browser/browserServerBackend.js +82 -0
- package/lib/mcp/browser/codegen.js +64 -0
- package/lib/mcp/browser/config.js +279 -0
- package/lib/mcp/browser/context.js +229 -0
- package/lib/mcp/browser/response.js +163 -0
- package/lib/mcp/browser/sessionLog.js +160 -0
- package/lib/mcp/browser/tab.js +256 -0
- package/lib/mcp/browser/tools/common.js +63 -0
- package/lib/mcp/browser/tools/console.js +41 -0
- package/lib/mcp/browser/tools/dialogs.js +55 -0
- package/lib/mcp/browser/tools/evaluate.js +70 -0
- package/lib/mcp/browser/tools/files.js +52 -0
- package/lib/mcp/browser/tools/form.js +73 -0
- package/lib/mcp/browser/tools/install.js +69 -0
- package/lib/mcp/browser/tools/keyboard.js +95 -0
- package/lib/mcp/browser/tools/mouse.js +107 -0
- package/lib/mcp/browser/tools/navigate.js +62 -0
- package/lib/mcp/browser/tools/network.js +49 -0
- package/lib/mcp/{sdk/call.js → browser/tools/pdf.js} +27 -18
- package/lib/mcp/browser/tools/screenshot.js +94 -0
- package/lib/mcp/browser/tools/snapshot.js +162 -0
- package/lib/mcp/browser/tools/tabs.js +67 -0
- package/lib/mcp/browser/tools/tool.js +49 -0
- package/lib/mcp/browser/tools/utils.js +90 -0
- package/lib/mcp/browser/tools/verify.js +154 -0
- package/lib/mcp/browser/tools/wait.js +63 -0
- package/lib/mcp/browser/tools.js +42 -83
- package/lib/mcp/config.d.js +16 -0
- package/lib/mcp/extension/cdpRelay.js +348 -0
- package/lib/mcp/extension/extensionContextFactory.js +75 -0
- package/lib/mcp/{browser/tool.js → extension/protocol.js} +6 -8
- package/lib/mcp/index.js +61 -0
- package/lib/mcp/log.js +35 -0
- package/lib/mcp/program.js +96 -0
- package/lib/mcp/sdk/bundle.js +11 -1
- package/lib/mcp/sdk/exports.js +2 -2
- package/lib/mcp/sdk/http.js +21 -6
- package/lib/mcp/sdk/mdb.js +16 -15
- package/lib/mcp/sdk/proxyBackend.js +7 -6
- package/lib/mcp/sdk/server.js +6 -6
- package/lib/mcp/sdk/tool.js +1 -1
- package/lib/mcp/{browser/backend.js → test/browserBackend.js} +7 -9
- package/lib/mcp/test/browserTool.js +30 -0
- package/lib/mcp/test/browserTools.js +120 -0
- package/lib/mcp/test/{backend.js → testBackend.js} +12 -12
- package/lib/mcp/test/{context.js → testContext.js} +6 -6
- package/lib/mcp/test/{tool.js → testTool.js} +6 -6
- package/lib/mcp/test/{tools.js → testTools.js} +7 -7
- package/lib/mcpBundleImpl.js +11 -11
- package/lib/program.js +4 -4
- package/package.json +6 -3
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# 🎭 Playwright
|
|
2
2
|
|
|
3
|
-
[](https://www.npmjs.com/package/playwright) <!-- GEN:chromium-version-badge -->[](https://www.npmjs.com/package/playwright) <!-- GEN:chromium-version-badge -->[](https://www.chromium.org/Home)<!-- GEN:stop --> <!-- GEN:firefox-version-badge -->[](https://www.mozilla.org/en-US/firefox/new/)<!-- GEN:stop --> <!-- GEN:webkit-version-badge -->[](https://webkit.org/)<!-- GEN:stop --> [](https://aka.ms/playwright/discord)
|
|
4
4
|
|
|
5
5
|
## [Documentation](https://playwright.dev) | [API reference](https://playwright.dev/docs/api/class-playwright)
|
|
6
6
|
|
|
@@ -8,7 +8,7 @@ Playwright is a framework for Web Testing and Automation. It allows testing [Chr
|
|
|
8
8
|
|
|
9
9
|
| | Linux | macOS | Windows |
|
|
10
10
|
| :--- | :---: | :---: | :---: |
|
|
11
|
-
| Chromium <!-- GEN:chromium-version -->140.0.7339.
|
|
11
|
+
| Chromium <!-- GEN:chromium-version -->140.0.7339.41<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
|
|
12
12
|
| WebKit <!-- GEN:webkit-version -->26.0<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
|
|
13
13
|
| Firefox <!-- GEN:firefox-version -->141.0<!-- GEN:stop --> | :white_check_mark: | :white_check_mark: | :white_check_mark: |
|
|
14
14
|
|
package/ThirdPartyNotices.txt
CHANGED
|
@@ -62,7 +62,7 @@ This project incorporates components from the projects listed below. The origina
|
|
|
62
62
|
- @jridgewell/resolve-uri@3.1.1 (https://github.com/jridgewell/resolve-uri)
|
|
63
63
|
- @jridgewell/sourcemap-codec@1.5.4 (https://github.com/jridgewell/sourcemaps)
|
|
64
64
|
- @jridgewell/trace-mapping@0.3.29 (https://github.com/jridgewell/sourcemaps)
|
|
65
|
-
- @modelcontextprotocol/sdk@1.17.
|
|
65
|
+
- @modelcontextprotocol/sdk@1.17.5 (https://github.com/modelcontextprotocol/typescript-sdk)
|
|
66
66
|
- @sinclair/typebox@0.27.8 (https://github.com/sinclairzx81/typebox)
|
|
67
67
|
- @types/istanbul-lib-coverage@2.0.6 (https://github.com/DefinitelyTyped/DefinitelyTyped)
|
|
68
68
|
- @types/istanbul-lib-report@3.0.3 (https://github.com/DefinitelyTyped/DefinitelyTyped)
|
|
@@ -1955,7 +1955,7 @@ SOFTWARE.
|
|
|
1955
1955
|
=========================================
|
|
1956
1956
|
END OF @jridgewell/trace-mapping@0.3.29 AND INFORMATION
|
|
1957
1957
|
|
|
1958
|
-
%% @modelcontextprotocol/sdk@1.17.
|
|
1958
|
+
%% @modelcontextprotocol/sdk@1.17.5 NOTICES AND INFORMATION BEGIN HERE
|
|
1959
1959
|
=========================================
|
|
1960
1960
|
MIT License
|
|
1961
1961
|
|
|
@@ -1979,7 +1979,7 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
1979
1979
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
1980
1980
|
SOFTWARE.
|
|
1981
1981
|
=========================================
|
|
1982
|
-
END OF @modelcontextprotocol/sdk@1.17.
|
|
1982
|
+
END OF @modelcontextprotocol/sdk@1.17.5 AND INFORMATION
|
|
1983
1983
|
|
|
1984
1984
|
%% @sinclair/typebox@0.27.8 NOTICES AND INFORMATION BEGIN HERE
|
|
1985
1985
|
=========================================
|
package/lib/index.js
CHANGED
|
@@ -42,7 +42,7 @@ var playwrightLibrary = __toESM(require("playwright-core"));
|
|
|
42
42
|
var import_utils = require("playwright-core/lib/utils");
|
|
43
43
|
var import_globals = require("./common/globals");
|
|
44
44
|
var import_testType = require("./common/testType");
|
|
45
|
-
var
|
|
45
|
+
var import_browserBackend = require("./mcp/test/browserBackend");
|
|
46
46
|
var import_babelBundle = require("./transform/babelBundle");
|
|
47
47
|
var import_util = require("./util");
|
|
48
48
|
var import_expect = require("./matchers/expect");
|
|
@@ -269,7 +269,7 @@ const playwrightFixtures = {
|
|
|
269
269
|
if (!page)
|
|
270
270
|
return;
|
|
271
271
|
recoveryHandlers.push(async () => {
|
|
272
|
-
await (0,
|
|
272
|
+
await (0, import_browserBackend.runBrowserBackendOnError)(page, () => {
|
|
273
273
|
return (0, import_util.stripAnsiEscapes)(createErrorCodeframe(error.message, step.location));
|
|
274
274
|
});
|
|
275
275
|
});
|
|
@@ -23,7 +23,7 @@ __export(toBeTruthy_exports, {
|
|
|
23
23
|
module.exports = __toCommonJS(toBeTruthy_exports);
|
|
24
24
|
var import_util = require("../util");
|
|
25
25
|
var import_matcherHint = require("./matcherHint");
|
|
26
|
-
var
|
|
26
|
+
var import_browserBackend = require("../mcp/test/browserBackend");
|
|
27
27
|
async function toBeTruthy(matcherName, receiver, receiverType, expected, arg, query, options = {}) {
|
|
28
28
|
(0, import_util.expectTypes)(receiver, [receiverType], matcherName);
|
|
29
29
|
const matcherOptions = {
|
|
@@ -32,7 +32,7 @@ async function toBeTruthy(matcherName, receiver, receiverType, expected, arg, qu
|
|
|
32
32
|
};
|
|
33
33
|
const timeout = options.timeout ?? this.timeout;
|
|
34
34
|
const { matches: pass, log, timedOut, received } = await query(!!this.isNot, timeout).catch(async (error) => {
|
|
35
|
-
await (0,
|
|
35
|
+
await (0, import_browserBackend.runBrowserBackendOnError)(receiver.page(), () => error.message);
|
|
36
36
|
throw error;
|
|
37
37
|
});
|
|
38
38
|
if (pass === !this.isNot) {
|
|
@@ -59,7 +59,7 @@ ${printedReceived}`);
|
|
|
59
59
|
const logText = (0, import_util.callLogText)(log);
|
|
60
60
|
return `${header}${logText}`;
|
|
61
61
|
};
|
|
62
|
-
await (0,
|
|
62
|
+
await (0, import_browserBackend.runBrowserBackendOnError)(receiver.page(), message);
|
|
63
63
|
return {
|
|
64
64
|
message,
|
|
65
65
|
pass,
|
package/lib/matchers/toEqual.js
CHANGED
|
@@ -24,7 +24,7 @@ module.exports = __toCommonJS(toEqual_exports);
|
|
|
24
24
|
var import_utils = require("playwright-core/lib/utils");
|
|
25
25
|
var import_util = require("../util");
|
|
26
26
|
var import_matcherHint = require("./matcherHint");
|
|
27
|
-
var
|
|
27
|
+
var import_browserBackend = require("../mcp/test/browserBackend");
|
|
28
28
|
const EXPECTED_LABEL = "Expected";
|
|
29
29
|
const RECEIVED_LABEL = "Received";
|
|
30
30
|
async function toEqual(matcherName, receiver, receiverType, query, expected, options = {}, messagePreventExtraStatIndent) {
|
|
@@ -36,7 +36,7 @@ async function toEqual(matcherName, receiver, receiverType, query, expected, opt
|
|
|
36
36
|
};
|
|
37
37
|
const timeout = options.timeout ?? this.timeout;
|
|
38
38
|
const { matches: pass, received, log, timedOut } = await query(!!this.isNot, timeout).catch(async (error) => {
|
|
39
|
-
await (0,
|
|
39
|
+
await (0, import_browserBackend.runBrowserBackendOnError)(receiver.page(), () => error.message);
|
|
40
40
|
throw error;
|
|
41
41
|
});
|
|
42
42
|
if (pass === !this.isNot) {
|
|
@@ -82,7 +82,7 @@ ${printedReceived}`;
|
|
|
82
82
|
const header = (0, import_matcherHint.matcherHint)(this, receiver, matcherName, "locator", void 0, matcherOptions, timedOut ? timeout : void 0, details, messagePreventExtraStatIndent);
|
|
83
83
|
return `${header}${(0, import_util.callLogText)(log)}`;
|
|
84
84
|
};
|
|
85
|
-
await (0,
|
|
85
|
+
await (0, import_browserBackend.runBrowserBackendOnError)(receiver.page(), message);
|
|
86
86
|
return {
|
|
87
87
|
actual: received,
|
|
88
88
|
expected,
|
|
@@ -26,7 +26,7 @@ var import_util = require("../util");
|
|
|
26
26
|
var import_expect = require("./expect");
|
|
27
27
|
var import_matcherHint = require("./matcherHint");
|
|
28
28
|
var import_expectBundle = require("../common/expectBundle");
|
|
29
|
-
var
|
|
29
|
+
var import_browserBackend = require("../mcp/test/browserBackend");
|
|
30
30
|
async function toMatchText(matcherName, receiver, receiverType, query, expected, options = {}) {
|
|
31
31
|
(0, import_util.expectTypes)(receiver, [receiverType], matcherName);
|
|
32
32
|
const matcherOptions = {
|
|
@@ -43,7 +43,7 @@ async function toMatchText(matcherName, receiver, receiverType, query, expected,
|
|
|
43
43
|
const timeout = options.timeout ?? this.timeout;
|
|
44
44
|
const { matches: pass, received, log, timedOut } = await query(!!this.isNot, timeout).catch(async (error) => {
|
|
45
45
|
if (receiverType === "Locator")
|
|
46
|
-
await (0,
|
|
46
|
+
await (0, import_browserBackend.runBrowserBackendOnError)(receiver.page(), () => error.message);
|
|
47
47
|
throw error;
|
|
48
48
|
});
|
|
49
49
|
if (pass === !this.isNot) {
|
|
@@ -95,7 +95,7 @@ async function toMatchText(matcherName, receiver, receiverType, query, expected,
|
|
|
95
95
|
return hints + (0, import_util.callLogText)(log);
|
|
96
96
|
};
|
|
97
97
|
if (receiverType === "Locator")
|
|
98
|
-
await (0,
|
|
98
|
+
await (0, import_browserBackend.runBrowserBackendOnError)(receiver.page(), message);
|
|
99
99
|
return {
|
|
100
100
|
name: matcherName,
|
|
101
101
|
expected,
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __copyProps = (to, from, except, desc) => {
|
|
7
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
8
|
+
for (let key of __getOwnPropNames(from))
|
|
9
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
10
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
11
|
+
}
|
|
12
|
+
return to;
|
|
13
|
+
};
|
|
14
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
15
|
+
var actions_d_exports = {};
|
|
16
|
+
module.exports = __toCommonJS(actions_d_exports);
|
|
@@ -0,0 +1,227 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __create = Object.create;
|
|
3
|
+
var __defProp = Object.defineProperty;
|
|
4
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
5
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
6
|
+
var __getProtoOf = Object.getPrototypeOf;
|
|
7
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
8
|
+
var __export = (target, all) => {
|
|
9
|
+
for (var name in all)
|
|
10
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
11
|
+
};
|
|
12
|
+
var __copyProps = (to, from, except, desc) => {
|
|
13
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
14
|
+
for (let key of __getOwnPropNames(from))
|
|
15
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
16
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
17
|
+
}
|
|
18
|
+
return to;
|
|
19
|
+
};
|
|
20
|
+
var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
|
|
21
|
+
// If the importer is in node compatibility mode or this is not an ESM
|
|
22
|
+
// file that has been converted to a CommonJS file using a Babel-
|
|
23
|
+
// compatible transform (i.e. "__esModule" has not been set), then set
|
|
24
|
+
// "default" to the CommonJS "module.exports" for node compatibility.
|
|
25
|
+
isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
|
|
26
|
+
mod
|
|
27
|
+
));
|
|
28
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
29
|
+
var browserContextFactory_exports = {};
|
|
30
|
+
__export(browserContextFactory_exports, {
|
|
31
|
+
contextFactory: () => contextFactory
|
|
32
|
+
});
|
|
33
|
+
module.exports = __toCommonJS(browserContextFactory_exports);
|
|
34
|
+
var import_crypto = __toESM(require("crypto"));
|
|
35
|
+
var import_fs = __toESM(require("fs"));
|
|
36
|
+
var import_net = __toESM(require("net"));
|
|
37
|
+
var import_path = __toESM(require("path"));
|
|
38
|
+
var playwright = __toESM(require("playwright-core"));
|
|
39
|
+
var import_registry = require("playwright-core/lib/server/registry/index");
|
|
40
|
+
var import_server = require("playwright-core/lib/server");
|
|
41
|
+
var import_log = require("../log");
|
|
42
|
+
var import_config = require("./config");
|
|
43
|
+
function contextFactory(config) {
|
|
44
|
+
if (config.browser.remoteEndpoint)
|
|
45
|
+
return new RemoteContextFactory(config);
|
|
46
|
+
if (config.browser.cdpEndpoint)
|
|
47
|
+
return new CdpContextFactory(config);
|
|
48
|
+
if (config.browser.isolated)
|
|
49
|
+
return new IsolatedContextFactory(config);
|
|
50
|
+
return new PersistentContextFactory(config);
|
|
51
|
+
}
|
|
52
|
+
class BaseContextFactory {
|
|
53
|
+
constructor(name, config) {
|
|
54
|
+
this._logName = name;
|
|
55
|
+
this.config = config;
|
|
56
|
+
}
|
|
57
|
+
async _obtainBrowser(clientInfo) {
|
|
58
|
+
if (this._browserPromise)
|
|
59
|
+
return this._browserPromise;
|
|
60
|
+
(0, import_log.testDebug)(`obtain browser (${this._logName})`);
|
|
61
|
+
this._browserPromise = this._doObtainBrowser(clientInfo);
|
|
62
|
+
void this._browserPromise.then((browser) => {
|
|
63
|
+
browser.on("disconnected", () => {
|
|
64
|
+
this._browserPromise = void 0;
|
|
65
|
+
});
|
|
66
|
+
}).catch(() => {
|
|
67
|
+
this._browserPromise = void 0;
|
|
68
|
+
});
|
|
69
|
+
return this._browserPromise;
|
|
70
|
+
}
|
|
71
|
+
async _doObtainBrowser(clientInfo) {
|
|
72
|
+
throw new Error("Not implemented");
|
|
73
|
+
}
|
|
74
|
+
async createContext(clientInfo) {
|
|
75
|
+
(0, import_log.testDebug)(`create browser context (${this._logName})`);
|
|
76
|
+
const browser = await this._obtainBrowser(clientInfo);
|
|
77
|
+
const browserContext = await this._doCreateContext(browser);
|
|
78
|
+
return { browserContext, close: () => this._closeBrowserContext(browserContext, browser) };
|
|
79
|
+
}
|
|
80
|
+
async _doCreateContext(browser) {
|
|
81
|
+
throw new Error("Not implemented");
|
|
82
|
+
}
|
|
83
|
+
async _closeBrowserContext(browserContext, browser) {
|
|
84
|
+
(0, import_log.testDebug)(`close browser context (${this._logName})`);
|
|
85
|
+
if (browser.contexts().length === 1)
|
|
86
|
+
this._browserPromise = void 0;
|
|
87
|
+
await browserContext.close().catch(import_log.logUnhandledError);
|
|
88
|
+
if (browser.contexts().length === 0) {
|
|
89
|
+
(0, import_log.testDebug)(`close browser (${this._logName})`);
|
|
90
|
+
await browser.close().catch(import_log.logUnhandledError);
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
class IsolatedContextFactory extends BaseContextFactory {
|
|
95
|
+
constructor(config) {
|
|
96
|
+
super("isolated", config);
|
|
97
|
+
}
|
|
98
|
+
async _doObtainBrowser(clientInfo) {
|
|
99
|
+
await injectCdpPort(this.config.browser);
|
|
100
|
+
const browserType = playwright[this.config.browser.browserName];
|
|
101
|
+
return browserType.launch({
|
|
102
|
+
tracesDir: await startTraceServer(this.config, clientInfo.rootPath),
|
|
103
|
+
...this.config.browser.launchOptions,
|
|
104
|
+
handleSIGINT: false,
|
|
105
|
+
handleSIGTERM: false
|
|
106
|
+
}).catch((error) => {
|
|
107
|
+
if (error.message.includes("Executable doesn't exist"))
|
|
108
|
+
throw new Error(`Browser specified in your config is not installed. Either install it (likely) or change the config.`);
|
|
109
|
+
throw error;
|
|
110
|
+
});
|
|
111
|
+
}
|
|
112
|
+
async _doCreateContext(browser) {
|
|
113
|
+
return browser.newContext(this.config.browser.contextOptions);
|
|
114
|
+
}
|
|
115
|
+
}
|
|
116
|
+
class CdpContextFactory extends BaseContextFactory {
|
|
117
|
+
constructor(config) {
|
|
118
|
+
super("cdp", config);
|
|
119
|
+
}
|
|
120
|
+
async _doObtainBrowser() {
|
|
121
|
+
return playwright.chromium.connectOverCDP(this.config.browser.cdpEndpoint);
|
|
122
|
+
}
|
|
123
|
+
async _doCreateContext(browser) {
|
|
124
|
+
return this.config.browser.isolated ? await browser.newContext() : browser.contexts()[0];
|
|
125
|
+
}
|
|
126
|
+
}
|
|
127
|
+
class RemoteContextFactory extends BaseContextFactory {
|
|
128
|
+
constructor(config) {
|
|
129
|
+
super("remote", config);
|
|
130
|
+
}
|
|
131
|
+
async _doObtainBrowser() {
|
|
132
|
+
const url = new URL(this.config.browser.remoteEndpoint);
|
|
133
|
+
url.searchParams.set("browser", this.config.browser.browserName);
|
|
134
|
+
if (this.config.browser.launchOptions)
|
|
135
|
+
url.searchParams.set("launch-options", JSON.stringify(this.config.browser.launchOptions));
|
|
136
|
+
return playwright[this.config.browser.browserName].connect(String(url));
|
|
137
|
+
}
|
|
138
|
+
async _doCreateContext(browser) {
|
|
139
|
+
return browser.newContext();
|
|
140
|
+
}
|
|
141
|
+
}
|
|
142
|
+
class PersistentContextFactory {
|
|
143
|
+
constructor(config) {
|
|
144
|
+
this.name = "persistent";
|
|
145
|
+
this.description = "Create a new persistent browser context";
|
|
146
|
+
this._userDataDirs = /* @__PURE__ */ new Set();
|
|
147
|
+
this.config = config;
|
|
148
|
+
}
|
|
149
|
+
async createContext(clientInfo) {
|
|
150
|
+
await injectCdpPort(this.config.browser);
|
|
151
|
+
(0, import_log.testDebug)("create browser context (persistent)");
|
|
152
|
+
const userDataDir = this.config.browser.userDataDir ?? await this._createUserDataDir(clientInfo.rootPath);
|
|
153
|
+
const tracesDir = await startTraceServer(this.config, clientInfo.rootPath);
|
|
154
|
+
this._userDataDirs.add(userDataDir);
|
|
155
|
+
(0, import_log.testDebug)("lock user data dir", userDataDir);
|
|
156
|
+
const browserType = playwright[this.config.browser.browserName];
|
|
157
|
+
for (let i = 0; i < 5; i++) {
|
|
158
|
+
try {
|
|
159
|
+
const browserContext = await browserType.launchPersistentContext(userDataDir, {
|
|
160
|
+
tracesDir,
|
|
161
|
+
...this.config.browser.launchOptions,
|
|
162
|
+
...this.config.browser.contextOptions,
|
|
163
|
+
handleSIGINT: false,
|
|
164
|
+
handleSIGTERM: false
|
|
165
|
+
});
|
|
166
|
+
const close = () => this._closeBrowserContext(browserContext, userDataDir);
|
|
167
|
+
return { browserContext, close };
|
|
168
|
+
} catch (error) {
|
|
169
|
+
if (error.message.includes("Executable doesn't exist"))
|
|
170
|
+
throw new Error(`Browser specified in your config is not installed. Either install it (likely) or change the config.`);
|
|
171
|
+
if (error.message.includes("ProcessSingleton") || error.message.includes("Invalid URL")) {
|
|
172
|
+
await new Promise((resolve) => setTimeout(resolve, 1e3));
|
|
173
|
+
continue;
|
|
174
|
+
}
|
|
175
|
+
throw error;
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
throw new Error(`Browser is already in use for ${userDataDir}, use --isolated to run multiple instances of the same browser`);
|
|
179
|
+
}
|
|
180
|
+
async _closeBrowserContext(browserContext, userDataDir) {
|
|
181
|
+
(0, import_log.testDebug)("close browser context (persistent)");
|
|
182
|
+
(0, import_log.testDebug)("release user data dir", userDataDir);
|
|
183
|
+
await browserContext.close().catch(() => {
|
|
184
|
+
});
|
|
185
|
+
this._userDataDirs.delete(userDataDir);
|
|
186
|
+
(0, import_log.testDebug)("close browser context complete (persistent)");
|
|
187
|
+
}
|
|
188
|
+
async _createUserDataDir(rootPath) {
|
|
189
|
+
const dir = process.env.PWMCP_PROFILES_DIR_FOR_TEST ?? import_registry.registryDirectory;
|
|
190
|
+
const browserToken = this.config.browser.launchOptions?.channel ?? this.config.browser?.browserName;
|
|
191
|
+
const rootPathToken = rootPath ? `-${createHash(rootPath)}` : "";
|
|
192
|
+
const result = import_path.default.join(dir, `mcp-${browserToken}${rootPathToken}`);
|
|
193
|
+
await import_fs.default.promises.mkdir(result, { recursive: true });
|
|
194
|
+
return result;
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
async function injectCdpPort(browserConfig) {
|
|
198
|
+
if (browserConfig.browserName === "chromium")
|
|
199
|
+
browserConfig.launchOptions.cdpPort = await findFreePort();
|
|
200
|
+
}
|
|
201
|
+
async function findFreePort() {
|
|
202
|
+
return new Promise((resolve, reject) => {
|
|
203
|
+
const server = import_net.default.createServer();
|
|
204
|
+
server.listen(0, () => {
|
|
205
|
+
const { port } = server.address();
|
|
206
|
+
server.close(() => resolve(port));
|
|
207
|
+
});
|
|
208
|
+
server.on("error", reject);
|
|
209
|
+
});
|
|
210
|
+
}
|
|
211
|
+
async function startTraceServer(config, rootPath) {
|
|
212
|
+
if (!config.saveTrace)
|
|
213
|
+
return void 0;
|
|
214
|
+
const tracesDir = await (0, import_config.outputFile)(config, rootPath, `traces-${Date.now()}`);
|
|
215
|
+
const server = await (0, import_server.startTraceViewerServer)();
|
|
216
|
+
const urlPrefix = server.urlPrefix("human-readable");
|
|
217
|
+
const url = urlPrefix + "/trace/index.html?trace=" + tracesDir + "/trace.json";
|
|
218
|
+
console.error("\nTrace viewer listening on " + url);
|
|
219
|
+
return tracesDir;
|
|
220
|
+
}
|
|
221
|
+
function createHash(data) {
|
|
222
|
+
return import_crypto.default.createHash("sha256").update(data).digest("hex").slice(0, 7);
|
|
223
|
+
}
|
|
224
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
225
|
+
0 && (module.exports = {
|
|
226
|
+
contextFactory
|
|
227
|
+
});
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __export = (target, all) => {
|
|
7
|
+
for (var name in all)
|
|
8
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
9
|
+
};
|
|
10
|
+
var __copyProps = (to, from, except, desc) => {
|
|
11
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
12
|
+
for (let key of __getOwnPropNames(from))
|
|
13
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
14
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
15
|
+
}
|
|
16
|
+
return to;
|
|
17
|
+
};
|
|
18
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
19
|
+
var browserServerBackend_exports = {};
|
|
20
|
+
__export(browserServerBackend_exports, {
|
|
21
|
+
BrowserServerBackend: () => BrowserServerBackend
|
|
22
|
+
});
|
|
23
|
+
module.exports = __toCommonJS(browserServerBackend_exports);
|
|
24
|
+
var import_url = require("url");
|
|
25
|
+
var import_context = require("./context");
|
|
26
|
+
var import_log = require("../log");
|
|
27
|
+
var import_response = require("./response");
|
|
28
|
+
var import_sessionLog = require("./sessionLog");
|
|
29
|
+
var import_tools = require("./tools");
|
|
30
|
+
var import_tool = require("../sdk/tool");
|
|
31
|
+
class BrowserServerBackend {
|
|
32
|
+
constructor(config, factory) {
|
|
33
|
+
this._config = config;
|
|
34
|
+
this._browserContextFactory = factory;
|
|
35
|
+
this._tools = (0, import_tools.filteredTools)(config);
|
|
36
|
+
}
|
|
37
|
+
async initialize(server, clientVersion, roots) {
|
|
38
|
+
let rootPath;
|
|
39
|
+
if (roots.length > 0) {
|
|
40
|
+
const firstRootUri = roots[0]?.uri;
|
|
41
|
+
const url = firstRootUri ? new URL(firstRootUri) : void 0;
|
|
42
|
+
rootPath = url ? (0, import_url.fileURLToPath)(url) : void 0;
|
|
43
|
+
}
|
|
44
|
+
this._sessionLog = this._config.saveSession ? await import_sessionLog.SessionLog.create(this._config, rootPath) : void 0;
|
|
45
|
+
this._context = new import_context.Context({
|
|
46
|
+
tools: this._tools,
|
|
47
|
+
config: this._config,
|
|
48
|
+
browserContextFactory: this._browserContextFactory,
|
|
49
|
+
sessionLog: this._sessionLog,
|
|
50
|
+
clientInfo: { ...clientVersion, rootPath }
|
|
51
|
+
});
|
|
52
|
+
}
|
|
53
|
+
async listTools() {
|
|
54
|
+
return this._tools.map((tool) => (0, import_tool.toMcpTool)(tool.schema));
|
|
55
|
+
}
|
|
56
|
+
async callTool(name, rawArguments) {
|
|
57
|
+
const tool = this._tools.find((tool2) => tool2.schema.name === name);
|
|
58
|
+
if (!tool)
|
|
59
|
+
throw new Error(`Tool "${name}" not found`);
|
|
60
|
+
const parsedArguments = tool.schema.inputSchema.parse(rawArguments || {});
|
|
61
|
+
const context = this._context;
|
|
62
|
+
const response = new import_response.Response(context, name, parsedArguments);
|
|
63
|
+
context.setRunningTool(name);
|
|
64
|
+
try {
|
|
65
|
+
await tool.handle(context, parsedArguments, response);
|
|
66
|
+
await response.finish();
|
|
67
|
+
this._sessionLog?.logResponse(response);
|
|
68
|
+
} catch (error) {
|
|
69
|
+
response.addError(String(error));
|
|
70
|
+
} finally {
|
|
71
|
+
context.setRunningTool(void 0);
|
|
72
|
+
}
|
|
73
|
+
return response.serialize();
|
|
74
|
+
}
|
|
75
|
+
serverClosed() {
|
|
76
|
+
void this._context?.dispose().catch(import_log.logUnhandledError);
|
|
77
|
+
}
|
|
78
|
+
}
|
|
79
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
80
|
+
0 && (module.exports = {
|
|
81
|
+
BrowserServerBackend
|
|
82
|
+
});
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __export = (target, all) => {
|
|
7
|
+
for (var name in all)
|
|
8
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
9
|
+
};
|
|
10
|
+
var __copyProps = (to, from, except, desc) => {
|
|
11
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
12
|
+
for (let key of __getOwnPropNames(from))
|
|
13
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
14
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
15
|
+
}
|
|
16
|
+
return to;
|
|
17
|
+
};
|
|
18
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
19
|
+
var codegen_exports = {};
|
|
20
|
+
__export(codegen_exports, {
|
|
21
|
+
escapeWithQuotes: () => escapeWithQuotes,
|
|
22
|
+
formatObject: () => formatObject,
|
|
23
|
+
quote: () => quote
|
|
24
|
+
});
|
|
25
|
+
module.exports = __toCommonJS(codegen_exports);
|
|
26
|
+
function escapeWithQuotes(text, char = "'") {
|
|
27
|
+
const stringified = JSON.stringify(text);
|
|
28
|
+
const escapedText = stringified.substring(1, stringified.length - 1).replace(/\\"/g, '"');
|
|
29
|
+
if (char === "'")
|
|
30
|
+
return char + escapedText.replace(/[']/g, "\\'") + char;
|
|
31
|
+
if (char === '"')
|
|
32
|
+
return char + escapedText.replace(/["]/g, '\\"') + char;
|
|
33
|
+
if (char === "`")
|
|
34
|
+
return char + escapedText.replace(/[`]/g, "\\`") + char;
|
|
35
|
+
throw new Error("Invalid escape char");
|
|
36
|
+
}
|
|
37
|
+
function quote(text) {
|
|
38
|
+
return escapeWithQuotes(text, "'");
|
|
39
|
+
}
|
|
40
|
+
function formatObject(value, indent = " ") {
|
|
41
|
+
if (typeof value === "string")
|
|
42
|
+
return quote(value);
|
|
43
|
+
if (Array.isArray(value))
|
|
44
|
+
return `[${value.map((o) => formatObject(o)).join(", ")}]`;
|
|
45
|
+
if (typeof value === "object") {
|
|
46
|
+
const keys = Object.keys(value).filter((key) => value[key] !== void 0).sort();
|
|
47
|
+
if (!keys.length)
|
|
48
|
+
return "{}";
|
|
49
|
+
const tokens = [];
|
|
50
|
+
for (const key of keys)
|
|
51
|
+
tokens.push(`${key}: ${formatObject(value[key])}`);
|
|
52
|
+
return `{
|
|
53
|
+
${indent}${tokens.join(`,
|
|
54
|
+
${indent}`)}
|
|
55
|
+
}`;
|
|
56
|
+
}
|
|
57
|
+
return String(value);
|
|
58
|
+
}
|
|
59
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
60
|
+
0 && (module.exports = {
|
|
61
|
+
escapeWithQuotes,
|
|
62
|
+
formatObject,
|
|
63
|
+
quote
|
|
64
|
+
});
|