cypress 13.17.0 → 14.0.1
Sign up to get free protection for your applications and to get access to all the features.
- package/angular/README.md +5 -0
- package/angular/angular/README.md +5 -0
- package/angular/angular/dist/index.d.ts +11 -2
- package/angular/angular/dist/index.js +944 -4
- package/angular/angular/package.json +16 -9
- package/angular/dist/index.d.ts +11 -2
- package/angular/dist/index.js +944 -4
- package/angular/package.json +16 -9
- package/lib/cli.js +1 -30
- package/lib/exec/spawn.js +29 -7
- package/mount-utils/dist/index.d.ts +0 -28
- package/mount-utils/dist/index.js +0 -27
- package/mount-utils/mount-utils/dist/index.d.ts +0 -28
- package/mount-utils/mount-utils/dist/index.js +0 -27
- package/package.json +5 -23
- package/react/README.md +5 -0
- package/react/dist/cypress-react.cjs.js +21 -676
- package/react/dist/cypress-react.esm-bundler.js +22 -676
- package/react/dist/index.d.ts +13 -30
- package/react/package.json +13 -15
- package/react/react/README.md +5 -0
- package/react/react/dist/cypress-react.cjs.js +21 -676
- package/react/react/dist/cypress-react.esm-bundler.js +22 -676
- package/react/react/dist/index.d.ts +13 -30
- package/react/react/package.json +13 -15
- package/svelte/README.md +6 -2
- package/svelte/dist/cypress-svelte.cjs.js +12 -12
- package/svelte/dist/cypress-svelte.esm-bundler.js +12 -12
- package/svelte/dist/index.d.ts +8 -179
- package/svelte/package.json +2 -2
- package/svelte/svelte/README.md +6 -2
- package/svelte/svelte/dist/cypress-svelte.cjs.js +12 -12
- package/svelte/svelte/dist/cypress-svelte.esm-bundler.js +12 -12
- package/svelte/svelte/dist/index.d.ts +8 -179
- package/svelte/svelte/package.json +2 -2
- package/types/cypress.d.ts +32 -49
- package/types/net-stubbing.d.ts +2 -7
- package/vue/dist/cypress-vue.cjs.js +380 -275
- package/vue/dist/cypress-vue.esm-bundler.js +382 -276
- package/vue/dist/index.d.ts +61 -78
- package/vue/package.json +2 -5
- package/vue/vue/dist/cypress-vue.cjs.js +380 -275
- package/vue/vue/dist/cypress-vue.esm-bundler.js +382 -276
- package/vue/vue/dist/index.d.ts +61 -78
- package/vue/vue/package.json +2 -5
- package/angular-signals/README.md +0 -11
- package/angular-signals/angular-signals/README.md +0 -11
- package/angular-signals/angular-signals/dist/index.d.ts +0 -136
- package/angular-signals/angular-signals/dist/index.js +0 -1861
- package/angular-signals/angular-signals/package.json +0 -74
- package/angular-signals/dist/index.d.ts +0 -136
- package/angular-signals/dist/index.js +0 -1861
- package/angular-signals/package.json +0 -74
- package/react18/README.md +0 -7
- package/react18/dist/cypress-react.cjs.js +0 -597
- package/react18/dist/cypress-react.esm-bundler.js +0 -574
- package/react18/dist/index.d.ts +0 -78
- package/react18/package.json +0 -71
- package/react18/react18/README.md +0 -7
- package/react18/react18/dist/cypress-react.cjs.js +0 -597
- package/react18/react18/dist/cypress-react.esm-bundler.js +0 -574
- package/react18/react18/dist/index.d.ts +0 -78
- package/react18/react18/package.json +0 -71
- package/vue2/README.md +0 -7
- package/vue2/dist/cypress-vue2.cjs.js +0 -20045
- package/vue2/dist/cypress-vue2.esm-bundler.js +0 -20042
- package/vue2/dist/index.d.ts +0 -207
- package/vue2/package.json +0 -65
- package/vue2/vue2/README.md +0 -7
- package/vue2/vue2/dist/cypress-vue2.cjs.js +0 -20045
- package/vue2/vue2/dist/cypress-vue2.esm-bundler.js +0 -20042
- package/vue2/vue2/dist/index.d.ts +0 -207
- package/vue2/vue2/package.json +0 -65
@@ -1,574 +0,0 @@
|
|
1
|
-
|
2
|
-
/**
|
3
|
-
* @cypress/react18 v0.0.0-development
|
4
|
-
* (c) 2024 Cypress.io
|
5
|
-
* Released under the MIT License
|
6
|
-
*/
|
7
|
-
|
8
|
-
import ReactDOM from 'react-dom/client';
|
9
|
-
import * as React from 'react';
|
10
|
-
import 'react-dom';
|
11
|
-
|
12
|
-
const ROOT_SELECTOR$1 = '[data-cy-root]';
|
13
|
-
/**
|
14
|
-
* Gets the root element used to mount the component.
|
15
|
-
* @returns {HTMLElement} The root element
|
16
|
-
* @throws {Error} If the root element is not found
|
17
|
-
*/
|
18
|
-
const getContainerEl$1 = () => {
|
19
|
-
const el = document.querySelector(ROOT_SELECTOR$1);
|
20
|
-
if (el) {
|
21
|
-
return el;
|
22
|
-
}
|
23
|
-
throw Error(`No element found that matches selector ${ROOT_SELECTOR$1}. Please add a root element with data-cy-root attribute to your "component-index.html" file so that Cypress can attach your component to the DOM.`);
|
24
|
-
};
|
25
|
-
|
26
|
-
/**
|
27
|
-
* Gets the display name of the component when possible.
|
28
|
-
* @param type {JSX} The type object returned from creating the react element.
|
29
|
-
* @param fallbackName {string} The alias, or fallback name to use when the name cannot be derived.
|
30
|
-
* @link https://github.com/facebook/react-devtools/blob/master/backend/getDisplayName.js
|
31
|
-
*/
|
32
|
-
function getDisplayName(node, fallbackName = 'Unknown') {
|
33
|
-
const type = node === null || node === void 0 ? void 0 : node.type;
|
34
|
-
if (!type) {
|
35
|
-
return fallbackName;
|
36
|
-
}
|
37
|
-
let displayName = null;
|
38
|
-
// The displayName property is not guaranteed to be a string.
|
39
|
-
// It's only safe to use for our purposes if it's a string.
|
40
|
-
// github.com/facebook/react-devtools/issues/803
|
41
|
-
if (typeof type.displayName === 'string') {
|
42
|
-
displayName = type.displayName;
|
43
|
-
}
|
44
|
-
if (!displayName) {
|
45
|
-
displayName = type.name || fallbackName;
|
46
|
-
}
|
47
|
-
// Facebook-specific hack to turn "Image [from Image.react]" into just "Image".
|
48
|
-
// We need displayName with module name for error reports but it clutters the DevTools.
|
49
|
-
const match = displayName.match(/^(.*) \[from (.*)\]$/);
|
50
|
-
if (match) {
|
51
|
-
const componentName = match[1];
|
52
|
-
const moduleName = match[2];
|
53
|
-
if (componentName && moduleName) {
|
54
|
-
if (moduleName === componentName ||
|
55
|
-
moduleName.startsWith(`${componentName}.`)) {
|
56
|
-
displayName = componentName;
|
57
|
-
}
|
58
|
-
}
|
59
|
-
}
|
60
|
-
return displayName;
|
61
|
-
}
|
62
|
-
|
63
|
-
const ROOT_SELECTOR = '[data-cy-root]';
|
64
|
-
/**
|
65
|
-
* Gets the root element used to mount the component.
|
66
|
-
* @returns {HTMLElement} The root element
|
67
|
-
* @throws {Error} If the root element is not found
|
68
|
-
*/
|
69
|
-
const getContainerEl = () => {
|
70
|
-
const el = document.querySelector(ROOT_SELECTOR);
|
71
|
-
if (el) {
|
72
|
-
return el;
|
73
|
-
}
|
74
|
-
throw Error(`No element found that matches selector ${ROOT_SELECTOR}. Please add a root element with data-cy-root attribute to your "component-index.html" file so that Cypress can attach your component to the DOM.`);
|
75
|
-
};
|
76
|
-
function checkForRemovedStyleOptions(mountingOptions) {
|
77
|
-
for (const key of ['cssFile', 'cssFiles', 'style', 'styles', 'stylesheet', 'stylesheets']) {
|
78
|
-
if (mountingOptions[key]) {
|
79
|
-
Cypress.utils.throwErrByPath('mount.removed_style_mounting_options', key);
|
80
|
-
}
|
81
|
-
}
|
82
|
-
}
|
83
|
-
/**
|
84
|
-
* Utility function to register CT side effects and run cleanup code during the "test:before:run" Cypress hook
|
85
|
-
* @param optionalCallback Callback to be called before the next test runs
|
86
|
-
*/
|
87
|
-
function setupHooks(optionalCallback) {
|
88
|
-
// We don't want CT side effects to run when e2e
|
89
|
-
// testing so we early return.
|
90
|
-
// System test to verify CT side effects do not pollute e2e: system-tests/test/e2e_with_mount_import_spec.ts
|
91
|
-
if (Cypress.testingType !== 'component') {
|
92
|
-
return;
|
93
|
-
}
|
94
|
-
// When running component specs, we cannot allow "cy.visit"
|
95
|
-
// because it will wipe out our preparation work, and does not make much sense
|
96
|
-
// thus we overwrite "cy.visit" to throw an error
|
97
|
-
Cypress.Commands.overwrite('visit', () => {
|
98
|
-
throw new Error('cy.visit from a component spec is not allowed');
|
99
|
-
});
|
100
|
-
Cypress.Commands.overwrite('session', () => {
|
101
|
-
throw new Error('cy.session from a component spec is not allowed');
|
102
|
-
});
|
103
|
-
Cypress.Commands.overwrite('origin', () => {
|
104
|
-
throw new Error('cy.origin from a component spec is not allowed');
|
105
|
-
});
|
106
|
-
// @ts-ignore
|
107
|
-
Cypress.on('test:before:after:run:async', () => {
|
108
|
-
optionalCallback === null || optionalCallback === void 0 ? void 0 : optionalCallback();
|
109
|
-
});
|
110
|
-
}
|
111
|
-
|
112
|
-
let mountCleanup;
|
113
|
-
/**
|
114
|
-
* Create an `mount` function. Performs all the non-React-version specific
|
115
|
-
* behavior related to mounting. The React-version-specific code
|
116
|
-
* is injected. This helps us to maintain a consistent public API
|
117
|
-
* and handle breaking changes in React's rendering API.
|
118
|
-
*
|
119
|
-
* This is designed to be consumed by `npm/react{16,17,18}`, and other React adapters,
|
120
|
-
* or people writing adapters for third-party, custom adapters.
|
121
|
-
*/
|
122
|
-
const makeMountFn = (type, jsx, options = {}, rerenderKey, internalMountOptions) => {
|
123
|
-
if (!internalMountOptions) {
|
124
|
-
throw Error('internalMountOptions must be provided with `render` and `reactDom` parameters');
|
125
|
-
}
|
126
|
-
// @ts-expect-error - this is removed but we want to check if a user is passing it, and error if they are.
|
127
|
-
if (options.alias) {
|
128
|
-
// @ts-expect-error
|
129
|
-
Cypress.utils.throwErrByPath('mount.alias', options.alias);
|
130
|
-
}
|
131
|
-
checkForRemovedStyleOptions(options);
|
132
|
-
mountCleanup = internalMountOptions.cleanup;
|
133
|
-
return cy
|
134
|
-
.then(() => {
|
135
|
-
var _a, _b, _c;
|
136
|
-
const reactDomToUse = internalMountOptions.reactDom;
|
137
|
-
const el = getContainerEl();
|
138
|
-
if (!el) {
|
139
|
-
throw new Error([
|
140
|
-
`[@cypress/react] 🔥 Hmm, cannot find root element to mount the component. Searched for ${ROOT_SELECTOR}`,
|
141
|
-
].join(' '));
|
142
|
-
}
|
143
|
-
const key = rerenderKey !== null && rerenderKey !== void 0 ? rerenderKey :
|
144
|
-
// @ts-ignore provide unique key to the the wrapped component to make sure we are rerendering between tests
|
145
|
-
(((_c = (_b = (_a = Cypress === null || Cypress === void 0 ? void 0 : Cypress.mocha) === null || _a === void 0 ? void 0 : _a.getRunner()) === null || _b === void 0 ? void 0 : _b.test) === null || _c === void 0 ? void 0 : _c.title) || '') + Math.random();
|
146
|
-
const props = {
|
147
|
-
key,
|
148
|
-
};
|
149
|
-
const reactComponent = React.createElement(options.strict ? React.StrictMode : React.Fragment, props, jsx);
|
150
|
-
// since we always surround the component with a fragment
|
151
|
-
// let's get back the original component
|
152
|
-
const userComponent = reactComponent.props.children;
|
153
|
-
internalMountOptions.render(reactComponent, el, reactDomToUse);
|
154
|
-
return (cy.wrap(userComponent, { log: false })
|
155
|
-
.then(() => {
|
156
|
-
return cy.wrap({
|
157
|
-
component: userComponent,
|
158
|
-
rerender: (newComponent) => makeMountFn('rerender', newComponent, options, key, internalMountOptions),
|
159
|
-
unmount: () => {
|
160
|
-
// @ts-expect-error - undocumented API
|
161
|
-
Cypress.utils.throwErrByPath('mount.unmount');
|
162
|
-
},
|
163
|
-
}, { log: false });
|
164
|
-
})
|
165
|
-
// by waiting, we delaying test execution for the next tick of event loop
|
166
|
-
// and letting hooks and component lifecycle methods to execute mount
|
167
|
-
// https://github.com/bahmutov/cypress-react-unit-test/issues/200
|
168
|
-
.wait(0, { log: false })
|
169
|
-
.then(() => {
|
170
|
-
if (options.log !== false) {
|
171
|
-
// Get the display name property via the component constructor
|
172
|
-
// @ts-ignore FIXME
|
173
|
-
const componentName = getDisplayName(jsx);
|
174
|
-
const jsxComponentName = `<${componentName} ... />`;
|
175
|
-
Cypress.log({
|
176
|
-
name: type,
|
177
|
-
type: 'parent',
|
178
|
-
message: [jsxComponentName],
|
179
|
-
// @ts-ignore
|
180
|
-
$el: el.children.item(0),
|
181
|
-
consoleProps: () => {
|
182
|
-
return {
|
183
|
-
// @ts-ignore protect the use of jsx functional components use ReactNode
|
184
|
-
props: jsx === null || jsx === void 0 ? void 0 : jsx.props,
|
185
|
-
description: type === 'mount' ? 'Mounts React component' : 'Rerenders mounted React component',
|
186
|
-
home: 'https://github.com/cypress-io/cypress',
|
187
|
-
};
|
188
|
-
},
|
189
|
-
});
|
190
|
-
}
|
191
|
-
}));
|
192
|
-
// Bluebird types are terrible. I don't think the return type can be carried without this cast
|
193
|
-
});
|
194
|
-
};
|
195
|
-
/**
|
196
|
-
* Create an `unmount` function. Performs all the non-React-version specific
|
197
|
-
* behavior related to unmounting.
|
198
|
-
*
|
199
|
-
* This is designed to be consumed by `npm/react{16,17,18}`, and other React adapters,
|
200
|
-
* or people writing adapters for third-party, custom adapters.
|
201
|
-
*
|
202
|
-
* @param {UnmountArgs} options used during unmounting
|
203
|
-
*/
|
204
|
-
const makeUnmountFn = (options) => {
|
205
|
-
return cy.then(() => {
|
206
|
-
var _a;
|
207
|
-
const wasUnmounted = mountCleanup === null || mountCleanup === void 0 ? void 0 : mountCleanup();
|
208
|
-
if (wasUnmounted && options.log) {
|
209
|
-
Cypress.log({
|
210
|
-
name: 'unmount',
|
211
|
-
type: 'parent',
|
212
|
-
message: [(_a = options.boundComponentMessage) !== null && _a !== void 0 ? _a : 'Unmounted component'],
|
213
|
-
consoleProps: () => {
|
214
|
-
return {
|
215
|
-
description: 'Unmounts React component',
|
216
|
-
parent: getContainerEl().parentNode,
|
217
|
-
home: 'https://github.com/cypress-io/cypress',
|
218
|
-
};
|
219
|
-
},
|
220
|
-
});
|
221
|
-
}
|
222
|
-
});
|
223
|
-
};
|
224
|
-
// Cleanup before each run
|
225
|
-
// NOTE: we cannot use unmount here because
|
226
|
-
// we are not in the context of a test
|
227
|
-
const preMountCleanup = () => {
|
228
|
-
mountCleanup === null || mountCleanup === void 0 ? void 0 : mountCleanup();
|
229
|
-
};
|
230
|
-
// Side effects from "import { mount } from '@cypress/<my-framework>'" are annoying, we should avoid doing this
|
231
|
-
// by creating an explicit function/import that the user can register in their 'component.js' support file,
|
232
|
-
// such as:
|
233
|
-
// import 'cypress/<my-framework>/support'
|
234
|
-
// or
|
235
|
-
// import { registerCT } from 'cypress/<my-framework>'
|
236
|
-
// registerCT()
|
237
|
-
// Note: This would be a breaking change
|
238
|
-
// it is required to unmount component in beforeEach hook in order to provide a clean state inside test
|
239
|
-
// because `mount` can be called after some preparation that can side effect unmount
|
240
|
-
// @see npm/react/cypress/component/advanced/set-timeout-example/loading-indicator-spec.js
|
241
|
-
setupHooks(preMountCleanup);
|
242
|
-
|
243
|
-
const debug = (
|
244
|
-
typeof process === 'object' &&
|
245
|
-
process.env &&
|
246
|
-
process.env.NODE_DEBUG &&
|
247
|
-
/\bsemver\b/i.test(process.env.NODE_DEBUG)
|
248
|
-
) ? (...args) => console.error('SEMVER', ...args)
|
249
|
-
: () => {};
|
250
|
-
|
251
|
-
var debug_1 = debug;
|
252
|
-
|
253
|
-
// Note: this is the semver.org version of the spec that it implements
|
254
|
-
// Not necessarily the package version of this code.
|
255
|
-
const SEMVER_SPEC_VERSION = '2.0.0';
|
256
|
-
|
257
|
-
const MAX_LENGTH$1 = 256;
|
258
|
-
const MAX_SAFE_INTEGER$1 = Number.MAX_SAFE_INTEGER ||
|
259
|
-
/* istanbul ignore next */ 9007199254740991;
|
260
|
-
|
261
|
-
// Max safe segment length for coercion.
|
262
|
-
const MAX_SAFE_COMPONENT_LENGTH = 16;
|
263
|
-
|
264
|
-
// Max safe length for a build identifier. The max length minus 6 characters for
|
265
|
-
// the shortest version with a build 0.0.0+BUILD.
|
266
|
-
const MAX_SAFE_BUILD_LENGTH = MAX_LENGTH$1 - 6;
|
267
|
-
|
268
|
-
const RELEASE_TYPES = [
|
269
|
-
'major',
|
270
|
-
'premajor',
|
271
|
-
'minor',
|
272
|
-
'preminor',
|
273
|
-
'patch',
|
274
|
-
'prepatch',
|
275
|
-
'prerelease',
|
276
|
-
];
|
277
|
-
|
278
|
-
var constants = {
|
279
|
-
MAX_LENGTH: MAX_LENGTH$1,
|
280
|
-
MAX_SAFE_COMPONENT_LENGTH,
|
281
|
-
MAX_SAFE_BUILD_LENGTH,
|
282
|
-
MAX_SAFE_INTEGER: MAX_SAFE_INTEGER$1,
|
283
|
-
RELEASE_TYPES,
|
284
|
-
SEMVER_SPEC_VERSION,
|
285
|
-
FLAG_INCLUDE_PRERELEASE: 0b001,
|
286
|
-
FLAG_LOOSE: 0b010,
|
287
|
-
};
|
288
|
-
|
289
|
-
function createCommonjsModule(fn) {
|
290
|
-
var module = { exports: {} };
|
291
|
-
return fn(module, module.exports), module.exports;
|
292
|
-
}
|
293
|
-
|
294
|
-
createCommonjsModule(function (module, exports) {
|
295
|
-
const {
|
296
|
-
MAX_SAFE_COMPONENT_LENGTH,
|
297
|
-
MAX_SAFE_BUILD_LENGTH,
|
298
|
-
MAX_LENGTH,
|
299
|
-
} = constants;
|
300
|
-
|
301
|
-
exports = module.exports = {};
|
302
|
-
|
303
|
-
// The actual regexps go on exports.re
|
304
|
-
const re = exports.re = [];
|
305
|
-
const safeRe = exports.safeRe = [];
|
306
|
-
const src = exports.src = [];
|
307
|
-
const t = exports.t = {};
|
308
|
-
let R = 0;
|
309
|
-
|
310
|
-
const LETTERDASHNUMBER = '[a-zA-Z0-9-]';
|
311
|
-
|
312
|
-
// Replace some greedy regex tokens to prevent regex dos issues. These regex are
|
313
|
-
// used internally via the safeRe object since all inputs in this library get
|
314
|
-
// normalized first to trim and collapse all extra whitespace. The original
|
315
|
-
// regexes are exported for userland consumption and lower level usage. A
|
316
|
-
// future breaking change could export the safer regex only with a note that
|
317
|
-
// all input should have extra whitespace removed.
|
318
|
-
const safeRegexReplacements = [
|
319
|
-
['\\s', 1],
|
320
|
-
['\\d', MAX_LENGTH],
|
321
|
-
[LETTERDASHNUMBER, MAX_SAFE_BUILD_LENGTH],
|
322
|
-
];
|
323
|
-
|
324
|
-
const makeSafeRegex = (value) => {
|
325
|
-
for (const [token, max] of safeRegexReplacements) {
|
326
|
-
value = value
|
327
|
-
.split(`${token}*`).join(`${token}{0,${max}}`)
|
328
|
-
.split(`${token}+`).join(`${token}{1,${max}}`);
|
329
|
-
}
|
330
|
-
return value
|
331
|
-
};
|
332
|
-
|
333
|
-
const createToken = (name, value, isGlobal) => {
|
334
|
-
const safe = makeSafeRegex(value);
|
335
|
-
const index = R++;
|
336
|
-
debug_1(name, index, value);
|
337
|
-
t[name] = index;
|
338
|
-
src[index] = value;
|
339
|
-
re[index] = new RegExp(value, isGlobal ? 'g' : undefined);
|
340
|
-
safeRe[index] = new RegExp(safe, isGlobal ? 'g' : undefined);
|
341
|
-
};
|
342
|
-
|
343
|
-
// The following Regular Expressions can be used for tokenizing,
|
344
|
-
// validating, and parsing SemVer version strings.
|
345
|
-
|
346
|
-
// ## Numeric Identifier
|
347
|
-
// A single `0`, or a non-zero digit followed by zero or more digits.
|
348
|
-
|
349
|
-
createToken('NUMERICIDENTIFIER', '0|[1-9]\\d*');
|
350
|
-
createToken('NUMERICIDENTIFIERLOOSE', '\\d+');
|
351
|
-
|
352
|
-
// ## Non-numeric Identifier
|
353
|
-
// Zero or more digits, followed by a letter or hyphen, and then zero or
|
354
|
-
// more letters, digits, or hyphens.
|
355
|
-
|
356
|
-
createToken('NONNUMERICIDENTIFIER', `\\d*[a-zA-Z-]${LETTERDASHNUMBER}*`);
|
357
|
-
|
358
|
-
// ## Main Version
|
359
|
-
// Three dot-separated numeric identifiers.
|
360
|
-
|
361
|
-
createToken('MAINVERSION', `(${src[t.NUMERICIDENTIFIER]})\\.` +
|
362
|
-
`(${src[t.NUMERICIDENTIFIER]})\\.` +
|
363
|
-
`(${src[t.NUMERICIDENTIFIER]})`);
|
364
|
-
|
365
|
-
createToken('MAINVERSIONLOOSE', `(${src[t.NUMERICIDENTIFIERLOOSE]})\\.` +
|
366
|
-
`(${src[t.NUMERICIDENTIFIERLOOSE]})\\.` +
|
367
|
-
`(${src[t.NUMERICIDENTIFIERLOOSE]})`);
|
368
|
-
|
369
|
-
// ## Pre-release Version Identifier
|
370
|
-
// A numeric identifier, or a non-numeric identifier.
|
371
|
-
|
372
|
-
createToken('PRERELEASEIDENTIFIER', `(?:${src[t.NUMERICIDENTIFIER]
|
373
|
-
}|${src[t.NONNUMERICIDENTIFIER]})`);
|
374
|
-
|
375
|
-
createToken('PRERELEASEIDENTIFIERLOOSE', `(?:${src[t.NUMERICIDENTIFIERLOOSE]
|
376
|
-
}|${src[t.NONNUMERICIDENTIFIER]})`);
|
377
|
-
|
378
|
-
// ## Pre-release Version
|
379
|
-
// Hyphen, followed by one or more dot-separated pre-release version
|
380
|
-
// identifiers.
|
381
|
-
|
382
|
-
createToken('PRERELEASE', `(?:-(${src[t.PRERELEASEIDENTIFIER]
|
383
|
-
}(?:\\.${src[t.PRERELEASEIDENTIFIER]})*))`);
|
384
|
-
|
385
|
-
createToken('PRERELEASELOOSE', `(?:-?(${src[t.PRERELEASEIDENTIFIERLOOSE]
|
386
|
-
}(?:\\.${src[t.PRERELEASEIDENTIFIERLOOSE]})*))`);
|
387
|
-
|
388
|
-
// ## Build Metadata Identifier
|
389
|
-
// Any combination of digits, letters, or hyphens.
|
390
|
-
|
391
|
-
createToken('BUILDIDENTIFIER', `${LETTERDASHNUMBER}+`);
|
392
|
-
|
393
|
-
// ## Build Metadata
|
394
|
-
// Plus sign, followed by one or more period-separated build metadata
|
395
|
-
// identifiers.
|
396
|
-
|
397
|
-
createToken('BUILD', `(?:\\+(${src[t.BUILDIDENTIFIER]
|
398
|
-
}(?:\\.${src[t.BUILDIDENTIFIER]})*))`);
|
399
|
-
|
400
|
-
// ## Full Version String
|
401
|
-
// A main version, followed optionally by a pre-release version and
|
402
|
-
// build metadata.
|
403
|
-
|
404
|
-
// Note that the only major, minor, patch, and pre-release sections of
|
405
|
-
// the version string are capturing groups. The build metadata is not a
|
406
|
-
// capturing group, because it should not ever be used in version
|
407
|
-
// comparison.
|
408
|
-
|
409
|
-
createToken('FULLPLAIN', `v?${src[t.MAINVERSION]
|
410
|
-
}${src[t.PRERELEASE]}?${
|
411
|
-
src[t.BUILD]}?`);
|
412
|
-
|
413
|
-
createToken('FULL', `^${src[t.FULLPLAIN]}$`);
|
414
|
-
|
415
|
-
// like full, but allows v1.2.3 and =1.2.3, which people do sometimes.
|
416
|
-
// also, 1.0.0alpha1 (prerelease without the hyphen) which is pretty
|
417
|
-
// common in the npm registry.
|
418
|
-
createToken('LOOSEPLAIN', `[v=\\s]*${src[t.MAINVERSIONLOOSE]
|
419
|
-
}${src[t.PRERELEASELOOSE]}?${
|
420
|
-
src[t.BUILD]}?`);
|
421
|
-
|
422
|
-
createToken('LOOSE', `^${src[t.LOOSEPLAIN]}$`);
|
423
|
-
|
424
|
-
createToken('GTLT', '((?:<|>)?=?)');
|
425
|
-
|
426
|
-
// Something like "2.*" or "1.2.x".
|
427
|
-
// Note that "x.x" is a valid xRange identifer, meaning "any version"
|
428
|
-
// Only the first item is strictly required.
|
429
|
-
createToken('XRANGEIDENTIFIERLOOSE', `${src[t.NUMERICIDENTIFIERLOOSE]}|x|X|\\*`);
|
430
|
-
createToken('XRANGEIDENTIFIER', `${src[t.NUMERICIDENTIFIER]}|x|X|\\*`);
|
431
|
-
|
432
|
-
createToken('XRANGEPLAIN', `[v=\\s]*(${src[t.XRANGEIDENTIFIER]})` +
|
433
|
-
`(?:\\.(${src[t.XRANGEIDENTIFIER]})` +
|
434
|
-
`(?:\\.(${src[t.XRANGEIDENTIFIER]})` +
|
435
|
-
`(?:${src[t.PRERELEASE]})?${
|
436
|
-
src[t.BUILD]}?` +
|
437
|
-
`)?)?`);
|
438
|
-
|
439
|
-
createToken('XRANGEPLAINLOOSE', `[v=\\s]*(${src[t.XRANGEIDENTIFIERLOOSE]})` +
|
440
|
-
`(?:\\.(${src[t.XRANGEIDENTIFIERLOOSE]})` +
|
441
|
-
`(?:\\.(${src[t.XRANGEIDENTIFIERLOOSE]})` +
|
442
|
-
`(?:${src[t.PRERELEASELOOSE]})?${
|
443
|
-
src[t.BUILD]}?` +
|
444
|
-
`)?)?`);
|
445
|
-
|
446
|
-
createToken('XRANGE', `^${src[t.GTLT]}\\s*${src[t.XRANGEPLAIN]}$`);
|
447
|
-
createToken('XRANGELOOSE', `^${src[t.GTLT]}\\s*${src[t.XRANGEPLAINLOOSE]}$`);
|
448
|
-
|
449
|
-
// Coercion.
|
450
|
-
// Extract anything that could conceivably be a part of a valid semver
|
451
|
-
createToken('COERCEPLAIN', `${'(^|[^\\d])' +
|
452
|
-
'(\\d{1,'}${MAX_SAFE_COMPONENT_LENGTH}})` +
|
453
|
-
`(?:\\.(\\d{1,${MAX_SAFE_COMPONENT_LENGTH}}))?` +
|
454
|
-
`(?:\\.(\\d{1,${MAX_SAFE_COMPONENT_LENGTH}}))?`);
|
455
|
-
createToken('COERCE', `${src[t.COERCEPLAIN]}(?:$|[^\\d])`);
|
456
|
-
createToken('COERCEFULL', src[t.COERCEPLAIN] +
|
457
|
-
`(?:${src[t.PRERELEASE]})?` +
|
458
|
-
`(?:${src[t.BUILD]})?` +
|
459
|
-
`(?:$|[^\\d])`);
|
460
|
-
createToken('COERCERTL', src[t.COERCE], true);
|
461
|
-
createToken('COERCERTLFULL', src[t.COERCEFULL], true);
|
462
|
-
|
463
|
-
// Tilde ranges.
|
464
|
-
// Meaning is "reasonably at or greater than"
|
465
|
-
createToken('LONETILDE', '(?:~>?)');
|
466
|
-
|
467
|
-
createToken('TILDETRIM', `(\\s*)${src[t.LONETILDE]}\\s+`, true);
|
468
|
-
exports.tildeTrimReplace = '$1~';
|
469
|
-
|
470
|
-
createToken('TILDE', `^${src[t.LONETILDE]}${src[t.XRANGEPLAIN]}$`);
|
471
|
-
createToken('TILDELOOSE', `^${src[t.LONETILDE]}${src[t.XRANGEPLAINLOOSE]}$`);
|
472
|
-
|
473
|
-
// Caret ranges.
|
474
|
-
// Meaning is "at least and backwards compatible with"
|
475
|
-
createToken('LONECARET', '(?:\\^)');
|
476
|
-
|
477
|
-
createToken('CARETTRIM', `(\\s*)${src[t.LONECARET]}\\s+`, true);
|
478
|
-
exports.caretTrimReplace = '$1^';
|
479
|
-
|
480
|
-
createToken('CARET', `^${src[t.LONECARET]}${src[t.XRANGEPLAIN]}$`);
|
481
|
-
createToken('CARETLOOSE', `^${src[t.LONECARET]}${src[t.XRANGEPLAINLOOSE]}$`);
|
482
|
-
|
483
|
-
// A simple gt/lt/eq thing, or just "" to indicate "any version"
|
484
|
-
createToken('COMPARATORLOOSE', `^${src[t.GTLT]}\\s*(${src[t.LOOSEPLAIN]})$|^$`);
|
485
|
-
createToken('COMPARATOR', `^${src[t.GTLT]}\\s*(${src[t.FULLPLAIN]})$|^$`);
|
486
|
-
|
487
|
-
// An expression to strip any whitespace between the gtlt and the thing
|
488
|
-
// it modifies, so that `> 1.2.3` ==> `>1.2.3`
|
489
|
-
createToken('COMPARATORTRIM', `(\\s*)${src[t.GTLT]
|
490
|
-
}\\s*(${src[t.LOOSEPLAIN]}|${src[t.XRANGEPLAIN]})`, true);
|
491
|
-
exports.comparatorTrimReplace = '$1$2$3';
|
492
|
-
|
493
|
-
// Something like `1.2.3 - 1.2.4`
|
494
|
-
// Note that these all use the loose form, because they'll be
|
495
|
-
// checked against either the strict or loose comparator form
|
496
|
-
// later.
|
497
|
-
createToken('HYPHENRANGE', `^\\s*(${src[t.XRANGEPLAIN]})` +
|
498
|
-
`\\s+-\\s+` +
|
499
|
-
`(${src[t.XRANGEPLAIN]})` +
|
500
|
-
`\\s*$`);
|
501
|
-
|
502
|
-
createToken('HYPHENRANGELOOSE', `^\\s*(${src[t.XRANGEPLAINLOOSE]})` +
|
503
|
-
`\\s+-\\s+` +
|
504
|
-
`(${src[t.XRANGEPLAINLOOSE]})` +
|
505
|
-
`\\s*$`);
|
506
|
-
|
507
|
-
// Star ranges basically just allow anything at all.
|
508
|
-
createToken('STAR', '(<|>)?=?\\s*\\*');
|
509
|
-
// >=0.0.0 is like a star
|
510
|
-
createToken('GTE0', '^\\s*>=\\s*0\\.0\\.0\\s*$');
|
511
|
-
createToken('GTE0PRE', '^\\s*>=\\s*0\\.0\\.0-0\\s*$');
|
512
|
-
});
|
513
|
-
|
514
|
-
// @ts-expect-error
|
515
|
-
let root;
|
516
|
-
const cleanup = () => {
|
517
|
-
if (root) {
|
518
|
-
root.unmount();
|
519
|
-
root = null;
|
520
|
-
return true;
|
521
|
-
}
|
522
|
-
return false;
|
523
|
-
};
|
524
|
-
/**
|
525
|
-
* Mounts a React component into the DOM.
|
526
|
-
* @param {import('react').JSX.Element} jsx The React component to mount.
|
527
|
-
* @param {MountOptions} options Options to pass to the mount function.
|
528
|
-
* @param {string} rerenderKey A key to use to force a rerender.
|
529
|
-
*
|
530
|
-
* @example
|
531
|
-
* import { mount } from '@cypress/react'
|
532
|
-
* import { Stepper } from './Stepper'
|
533
|
-
*
|
534
|
-
* it('mounts', () => {
|
535
|
-
* mount(<StepperComponent />)
|
536
|
-
* cy.get('[data-cy=increment]').click()
|
537
|
-
* cy.get('[data-cy=counter]').should('have.text', '1')
|
538
|
-
* }
|
539
|
-
*
|
540
|
-
* @see {@link https://on.cypress.io/mounting-react} for more details.
|
541
|
-
*
|
542
|
-
* @returns {Cypress.Chainable<MountReturn>} The mounted component.
|
543
|
-
*/
|
544
|
-
function mount(jsx, options = {}, rerenderKey) {
|
545
|
-
// Remove last mounted component if cy.mount is called more than once in a test
|
546
|
-
// React by default removes the last component when calling render, but we should remove the root
|
547
|
-
// to wipe away any state
|
548
|
-
cleanup();
|
549
|
-
const internalOptions = {
|
550
|
-
reactDom: ReactDOM,
|
551
|
-
render: (reactComponent, el) => {
|
552
|
-
if (!root) {
|
553
|
-
root = ReactDOM.createRoot(el);
|
554
|
-
}
|
555
|
-
return root.render(reactComponent);
|
556
|
-
},
|
557
|
-
unmount: internalUnmount,
|
558
|
-
cleanup,
|
559
|
-
};
|
560
|
-
return makeMountFn('mount', jsx, Object.assign({ ReactDom: ReactDOM }, options), rerenderKey, internalOptions);
|
561
|
-
}
|
562
|
-
function internalUnmount(options = { log: true }) {
|
563
|
-
return makeUnmountFn(options);
|
564
|
-
}
|
565
|
-
/**
|
566
|
-
* Removed as of Cypress 11.0.0.
|
567
|
-
* @see https://on.cypress.io/migration-11-0-0-component-testing-updates
|
568
|
-
*/
|
569
|
-
function unmount(options = { log: true }) {
|
570
|
-
// @ts-expect-error - undocumented API
|
571
|
-
Cypress.utils.throwErrByPath('mount.unmount');
|
572
|
-
}
|
573
|
-
|
574
|
-
export { getContainerEl$1 as getContainerEl, mount, unmount };
|
package/react18/dist/index.d.ts
DELETED
@@ -1,78 +0,0 @@
|
|
1
|
-
/// <reference types="cypress" />
|
2
|
-
|
3
|
-
/// <reference types="cypress" />
|
4
|
-
import React__default from 'react';
|
5
|
-
import * as react_dom from 'react-dom';
|
6
|
-
|
7
|
-
/**
|
8
|
-
* Gets the root element used to mount the component.
|
9
|
-
* @returns {HTMLElement} The root element
|
10
|
-
* @throws {Error} If the root element is not found
|
11
|
-
*/
|
12
|
-
declare const getContainerEl: () => HTMLElement;
|
13
|
-
|
14
|
-
interface UnmountArgs {
|
15
|
-
log: boolean;
|
16
|
-
boundComponentMessage?: string;
|
17
|
-
}
|
18
|
-
type MountOptions = Partial<MountReactComponentOptions>;
|
19
|
-
interface MountReactComponentOptions {
|
20
|
-
ReactDom: typeof react_dom;
|
21
|
-
/**
|
22
|
-
* Log the mounting command into Cypress Command Log,
|
23
|
-
* true by default.
|
24
|
-
*/
|
25
|
-
log: boolean;
|
26
|
-
/**
|
27
|
-
* Render component in React [strict mode](https://reactjs.org/docs/strict-mode.html)
|
28
|
-
* It activates additional checks and warnings for child components.
|
29
|
-
*/
|
30
|
-
strict: boolean;
|
31
|
-
}
|
32
|
-
interface MountReturn {
|
33
|
-
/**
|
34
|
-
* The component that was rendered.
|
35
|
-
*/
|
36
|
-
component: React__default.ReactNode;
|
37
|
-
/**
|
38
|
-
* Rerenders the specified component with new props. This allows testing of components that store state (`setState`)
|
39
|
-
* or have asynchronous updates (`useEffect`, `useLayoutEffect`).
|
40
|
-
*/
|
41
|
-
rerender: (component: React__default.ReactNode) => globalThis.Cypress.Chainable<MountReturn>;
|
42
|
-
/**
|
43
|
-
* Removes the mounted component.
|
44
|
-
*
|
45
|
-
* Removed as of Cypress 11.0.0.
|
46
|
-
* @see https://on.cypress.io/migration-11-0-0-component-testing-updates
|
47
|
-
*/
|
48
|
-
unmount: (payload: UnmountArgs) => void;
|
49
|
-
}
|
50
|
-
|
51
|
-
/**
|
52
|
-
* Mounts a React component into the DOM.
|
53
|
-
* @param {import('react').JSX.Element} jsx The React component to mount.
|
54
|
-
* @param {MountOptions} options Options to pass to the mount function.
|
55
|
-
* @param {string} rerenderKey A key to use to force a rerender.
|
56
|
-
*
|
57
|
-
* @example
|
58
|
-
* import { mount } from '@cypress/react'
|
59
|
-
* import { Stepper } from './Stepper'
|
60
|
-
*
|
61
|
-
* it('mounts', () => {
|
62
|
-
* mount(<StepperComponent />)
|
63
|
-
* cy.get('[data-cy=increment]').click()
|
64
|
-
* cy.get('[data-cy=counter]').should('have.text', '1')
|
65
|
-
* }
|
66
|
-
*
|
67
|
-
* @see {@link https://on.cypress.io/mounting-react} for more details.
|
68
|
-
*
|
69
|
-
* @returns {Cypress.Chainable<MountReturn>} The mounted component.
|
70
|
-
*/
|
71
|
-
declare function mount(jsx: React__default.ReactNode, options?: MountOptions, rerenderKey?: string): Cypress.Chainable<MountReturn>;
|
72
|
-
/**
|
73
|
-
* Removed as of Cypress 11.0.0.
|
74
|
-
* @see https://on.cypress.io/migration-11-0-0-component-testing-updates
|
75
|
-
*/
|
76
|
-
declare function unmount(options?: UnmountArgs): void;
|
77
|
-
|
78
|
-
export { MountOptions, MountReturn, getContainerEl, mount, unmount };
|