/** * @license Angular v16.2.12 * (c) 2010-2022 Google LLC. https://angular.io/ * License: MIT */ import * as i0 from '@angular/core'; import { EventEmitter, Injectable, InjectionToken, Inject, Optional } from '@angular/core'; import { LocationStrategy, Location } from '@angular/common'; import { Subject } from 'rxjs'; /** * Joins two parts of a URL with a slash if needed. * * @param start URL string * @param end URL string * * * @returns The joined URL string. */ function joinWithSlash(start, end) { if (start.length == 0) { return end; } if (end.length == 0) { return start; } let slashes = 0; if (start.endsWith('/')) { slashes++; } if (end.startsWith('/')) { slashes++; } if (slashes == 2) { return start + end.substring(1); } if (slashes == 1) { return start + end; } return start + '/' + end; } /** * Removes a trailing slash from a URL string if needed. * Looks for the first occurrence of either `#`, `?`, or the end of the * line as `/` characters and removes the trailing slash if one exists. * * @param url URL string. * * @returns The URL string, modified if needed. */ function stripTrailingSlash(url) { const match = url.match(/#|\?|$/); const pathEndIdx = match && match.index || url.length; const droppedSlashIdx = pathEndIdx - (url[pathEndIdx - 1] === '/' ? 1 : 0); return url.slice(0, droppedSlashIdx) + url.slice(pathEndIdx); } /** * Normalizes URL parameters by prepending with `?` if needed. * * @param params String of URL parameters. * * @returns The normalized URL parameters string. */ function normalizeQueryParams(params) { return params && params[0] !== '?' ? '?' + params : params; } /** * A spy for {@link Location} that allows tests to fire simulated location events. * * @publicApi */ class SpyLocation { constructor() { this.urlChanges = []; this._history = [new LocationState('', '', null)]; this._historyIndex = 0; /** @internal */ this._subject = new EventEmitter(); /** @internal */ this._basePath = ''; /** @internal */ this._locationStrategy = null; /** @internal */ this._urlChangeListeners = []; /** @internal */ this._urlChangeSubscription = null; } /** @nodoc */ ngOnDestroy() { this._urlChangeSubscription?.unsubscribe(); this._urlChangeListeners = []; } setInitialPath(url) { this._history[this._historyIndex].path = url; } setBaseHref(url) { this._basePath = url; } path() { return this._history[this._historyIndex].path; } getState() { return this._history[this._historyIndex].state; } isCurrentPathEqualTo(path, query = '') { const givenPath = path.endsWith('/') ? path.substring(0, path.length - 1) : path; const currPath = this.path().endsWith('/') ? this.path().substring(0, this.path().length - 1) : this.path(); return currPath == givenPath + (query.length > 0 ? ('?' + query) : ''); } simulateUrlPop(pathname) { this._subject.emit({ 'url': pathname, 'pop': true, 'type': 'popstate' }); } simulateHashChange(pathname) { const path = this.prepareExternalUrl(pathname); this.pushHistory(path, '', null); this.urlChanges.push('hash: ' + pathname); // the browser will automatically fire popstate event before each `hashchange` event, so we need // to simulate it. this._subject.emit({ 'url': pathname, 'pop': true, 'type': 'popstate' }); this._subject.emit({ 'url': pathname, 'pop': true, 'type': 'hashchange' }); } prepareExternalUrl(url) { if (url.length > 0 && !url.startsWith('/')) { url = '/' + url; } return this._basePath + url; } go(path, query = '', state = null) { path = this.prepareExternalUrl(path); this.pushHistory(path, query, state); const locationState = this._history[this._historyIndex - 1]; if (locationState.path == path && locationState.query == query) { return; } const url = path + (query.length > 0 ? ('?' + query) : ''); this.urlChanges.push(url); this._notifyUrlChangeListeners(path + normalizeQueryParams(query), state); } replaceState(path, query = '', state = null) { path = this.prepareExternalUrl(path); const history = this._history[this._historyIndex]; history.state = state; if (history.path == path && history.query == query) { return; } history.path = path; history.query = query; const url = path + (query.length > 0 ? ('?' + query) : ''); this.urlChanges.push('replace: ' + url); this._notifyUrlChangeListeners(path + normalizeQueryParams(query), state); } forward() { if (this._historyIndex < (this._history.length - 1)) { this._historyIndex++; this._subject.emit({ 'url': this.path(), 'state': this.getState(), 'pop': true, 'type': 'popstate' }); } } back() { if (this._historyIndex > 0) { this._historyIndex--; this._subject.emit({ 'url': this.path(), 'state': this.getState(), 'pop': true, 'type': 'popstate' }); } } historyGo(relativePosition = 0) { const nextPageIndex = this._historyIndex + relativePosition; if (nextPageIndex >= 0 && nextPageIndex < this._history.length) { this._historyIndex = nextPageIndex; this._subject.emit({ 'url': this.path(), 'state': this.getState(), 'pop': true, 'type': 'popstate' }); } } onUrlChange(fn) { this._urlChangeListeners.push(fn); if (!this._urlChangeSubscription) { this._urlChangeSubscription = this.subscribe(v => { this._notifyUrlChangeListeners(v.url, v.state); }); } return () => { const fnIndex = this._urlChangeListeners.indexOf(fn); this._urlChangeListeners.splice(fnIndex, 1); if (this._urlChangeListeners.length === 0) { this._urlChangeSubscription?.unsubscribe(); this._urlChangeSubscription = null; } }; } /** @internal */ _notifyUrlChangeListeners(url = '', state) { this._urlChangeListeners.forEach(fn => fn(url, state)); } subscribe(onNext, onThrow, onReturn) { return this._subject.subscribe({ next: onNext, error: onThrow, complete: onReturn }); } normalize(url) { return null; } pushHistory(path, query, state) { if (this._historyIndex > 0) { this._history.splice(this._historyIndex + 1); } this._history.push(new LocationState(path, query, state)); this._historyIndex = this._history.length - 1; } static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: SpyLocation, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); } static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: SpyLocation }); } } i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: SpyLocation, decorators: [{ type: Injectable }] }); class LocationState { constructor(path, query, state) { this.path = path; this.query = query; this.state = state; } } /** * A mock implementation of {@link LocationStrategy} that allows tests to fire simulated * location events. * * @publicApi */ class MockLocationStrategy extends LocationStrategy { constructor() { super(); this.internalBaseHref = '/'; this.internalPath = '/'; this.internalTitle = ''; this.urlChanges = []; /** @internal */ this._subject = new EventEmitter(); this.stateChanges = []; } simulatePopState(url) { this.internalPath = url; this._subject.emit(new _MockPopStateEvent(this.path())); } path(includeHash = false) { return this.internalPath; } prepareExternalUrl(internal) { if (internal.startsWith('/') && this.internalBaseHref.endsWith('/')) { return this.internalBaseHref + internal.substring(1); } return this.internalBaseHref + internal; } pushState(ctx, title, path, query) { // Add state change to changes array this.stateChanges.push(ctx); this.internalTitle = title; const url = path + (query.length > 0 ? ('?' + query) : ''); this.internalPath = url; const externalUrl = this.prepareExternalUrl(url); this.urlChanges.push(externalUrl); } replaceState(ctx, title, path, query) { // Reset the last index of stateChanges to the ctx (state) object this.stateChanges[(this.stateChanges.length || 1) - 1] = ctx; this.internalTitle = title; const url = path + (query.length > 0 ? ('?' + query) : ''); this.internalPath = url; const externalUrl = this.prepareExternalUrl(url); this.urlChanges.push('replace: ' + externalUrl); } onPopState(fn) { this._subject.subscribe({ next: fn }); } getBaseHref() { return this.internalBaseHref; } back() { if (this.urlChanges.length > 0) { this.urlChanges.pop(); this.stateChanges.pop(); const nextUrl = this.urlChanges.length > 0 ? this.urlChanges[this.urlChanges.length - 1] : ''; this.simulatePopState(nextUrl); } } forward() { throw 'not implemented'; } getState() { return this.stateChanges[(this.stateChanges.length || 1) - 1]; } static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: MockLocationStrategy, deps: [], target: i0.ɵɵFactoryTarget.Injectable }); } static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: MockLocationStrategy }); } } i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: MockLocationStrategy, decorators: [{ type: Injectable }], ctorParameters: function () { return []; } }); class _MockPopStateEvent { constructor(newUrl) { this.newUrl = newUrl; this.pop = true; this.type = 'popstate'; } } /** * Parser from https://tools.ietf.org/html/rfc3986#appendix-B * ^(([^:/?#]+):)?(//([^/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))? * 12 3 4 5 6 7 8 9 * * Example: http://www.ics.uci.edu/pub/ietf/uri/#Related * * Results in: * * $1 = http: * $2 = http * $3 = //www.ics.uci.edu * $4 = www.ics.uci.edu * $5 = /pub/ietf/uri/ * $6 = * $7 = * $8 = #Related * $9 = Related */ const urlParse = /^(([^:\/?#]+):)?(\/\/([^\/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?/; function parseUrl(urlStr, baseHref) { const verifyProtocol = /^((http[s]?|ftp):\/\/)/; let serverBase; // URL class requires full URL. If the URL string doesn't start with protocol, we need to add // an arbitrary base URL which can be removed afterward. if (!verifyProtocol.test(urlStr)) { serverBase = 'http://empty.com/'; } let parsedUrl; try { parsedUrl = new URL(urlStr, serverBase); } catch (e) { const result = urlParse.exec(serverBase || '' + urlStr); if (!result) { throw new Error(`Invalid URL: ${urlStr} with base: ${baseHref}`); } const hostSplit = result[4].split(':'); parsedUrl = { protocol: result[1], hostname: hostSplit[0], port: hostSplit[1] || '', pathname: result[5], search: result[6], hash: result[8], }; } if (parsedUrl.pathname && parsedUrl.pathname.indexOf(baseHref) === 0) { parsedUrl.pathname = parsedUrl.pathname.substring(baseHref.length); } return { hostname: !serverBase && parsedUrl.hostname || '', protocol: !serverBase && parsedUrl.protocol || '', port: !serverBase && parsedUrl.port || '', pathname: parsedUrl.pathname || '/', search: parsedUrl.search || '', hash: parsedUrl.hash || '', }; } /** * Provider for mock platform location config * * @publicApi */ const MOCK_PLATFORM_LOCATION_CONFIG = new InjectionToken('MOCK_PLATFORM_LOCATION_CONFIG'); /** * Mock implementation of URL state. * * @publicApi */ class MockPlatformLocation { constructor(config) { this.baseHref = ''; this.hashUpdate = new Subject(); this.popStateSubject = new Subject(); this.urlChangeIndex = 0; this.urlChanges = [{ hostname: '', protocol: '', port: '', pathname: '/', search: '', hash: '', state: null }]; if (config) { this.baseHref = config.appBaseHref || ''; const parsedChanges = this.parseChanges(null, config.startUrl || 'http://_empty_/', this.baseHref); this.urlChanges[0] = { ...parsedChanges }; } } get hostname() { return this.urlChanges[this.urlChangeIndex].hostname; } get protocol() { return this.urlChanges[this.urlChangeIndex].protocol; } get port() { return this.urlChanges[this.urlChangeIndex].port; } get pathname() { return this.urlChanges[this.urlChangeIndex].pathname; } get search() { return this.urlChanges[this.urlChangeIndex].search; } get hash() { return this.urlChanges[this.urlChangeIndex].hash; } get state() { return this.urlChanges[this.urlChangeIndex].state; } getBaseHrefFromDOM() { return this.baseHref; } onPopState(fn) { const subscription = this.popStateSubject.subscribe(fn); return () => subscription.unsubscribe(); } onHashChange(fn) { const subscription = this.hashUpdate.subscribe(fn); return () => subscription.unsubscribe(); } get href() { let url = `${this.protocol}//${this.hostname}${this.port ? ':' + this.port : ''}`; url += `${this.pathname === '/' ? '' : this.pathname}${this.search}${this.hash}`; return url; } get url() { return `${this.pathname}${this.search}${this.hash}`; } parseChanges(state, url, baseHref = '') { // When the `history.state` value is stored, it is always copied. state = JSON.parse(JSON.stringify(state)); return { ...parseUrl(url, baseHref), state }; } replaceState(state, title, newUrl) { const { pathname, search, state: parsedState, hash } = this.parseChanges(state, newUrl); this.urlChanges[this.urlChangeIndex] = { ...this.urlChanges[this.urlChangeIndex], pathname, search, hash, state: parsedState }; } pushState(state, title, newUrl) { const { pathname, search, state: parsedState, hash } = this.parseChanges(state, newUrl); if (this.urlChangeIndex > 0) { this.urlChanges.splice(this.urlChangeIndex + 1); } this.urlChanges.push({ ...this.urlChanges[this.urlChangeIndex], pathname, search, hash, state: parsedState }); this.urlChangeIndex = this.urlChanges.length - 1; } forward() { const oldUrl = this.url; const oldHash = this.hash; if (this.urlChangeIndex < this.urlChanges.length) { this.urlChangeIndex++; } this.emitEvents(oldHash, oldUrl); } back() { const oldUrl = this.url; const oldHash = this.hash; if (this.urlChangeIndex > 0) { this.urlChangeIndex--; } this.emitEvents(oldHash, oldUrl); } historyGo(relativePosition = 0) { const oldUrl = this.url; const oldHash = this.hash; const nextPageIndex = this.urlChangeIndex + relativePosition; if (nextPageIndex >= 0 && nextPageIndex < this.urlChanges.length) { this.urlChangeIndex = nextPageIndex; } this.emitEvents(oldHash, oldUrl); } getState() { return this.state; } /** * Browsers are inconsistent in when they fire events and perform the state updates * The most easiest thing to do in our mock is synchronous and that happens to match * Firefox and Chrome, at least somewhat closely * * https://github.com/WICG/navigation-api#watching-for-navigations * https://docs.google.com/document/d/1Pdve-DJ1JCGilj9Yqf5HxRJyBKSel5owgOvUJqTauwU/edit#heading=h.3ye4v71wsz94 * popstate is always sent before hashchange: * https://developer.mozilla.org/en-US/docs/Web/API/Window/popstate_event#when_popstate_is_sent */ emitEvents(oldHash, oldUrl) { this.popStateSubject.next({ type: 'popstate', state: this.getState(), oldUrl, newUrl: this.url }); if (oldHash !== this.hash) { this.hashUpdate.next({ type: 'hashchange', state: null, oldUrl, newUrl: this.url }); } } static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: MockPlatformLocation, deps: [{ token: MOCK_PLATFORM_LOCATION_CONFIG, optional: true }], target: i0.ɵɵFactoryTarget.Injectable }); } static { this.ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: MockPlatformLocation }); } } i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "16.2.12", ngImport: i0, type: MockPlatformLocation, decorators: [{ type: Injectable }], ctorParameters: function () { return [{ type: undefined, decorators: [{ type: Inject, args: [MOCK_PLATFORM_LOCATION_CONFIG] }, { type: Optional }] }]; } }); /** * Returns mock providers for the `Location` and `LocationStrategy` classes. * The mocks are helpful in tests to fire simulated location events. * * @publicApi */ function provideLocationMocks() { return [ { provide: Location, useClass: SpyLocation }, { provide: LocationStrategy, useClass: MockLocationStrategy }, ]; } /** * @module * @description * Entry point for all public APIs of the common/testing package. */ /** * @module * @description * Entry point for all public APIs of this package. */ // This file only reexports content of the `src` folder. Keep it that way. // This file is not used to build this module. It is only used during editing /** * Generated bundle index. Do not edit. */ export { MOCK_PLATFORM_LOCATION_CONFIG, MockLocationStrategy, MockPlatformLocation, SpyLocation, provideLocationMocks }; //# sourceMappingURL=testing.mjs.map