/* global __NEXT_DATA__ */ // tslint:disable:no-console import { ParsedUrlQuery } from 'querystring' import { ComponentType } from 'react' import { parse, UrlObject } from 'url' import mitt, { MittEmitter } from '../mitt' import { AppContextType, formatWithValidation, getURL, loadGetInitialProps, NextPageContext, ST, } from '../utils' import { isDynamicRoute } from './utils/is-dynamic' import { getRouteMatcher } from './utils/route-matcher' import { getRouteRegex } from './utils/route-regex' import { normalizeTrailingSlash, removePathTrailingSlash, } from '../../../client/normalize-trailing-slash' const basePath = (process.env.__NEXT_ROUTER_BASEPATH as string) || '' export function addBasePath(path: string): string { return basePath ? (path === '/' ? basePath : basePath + path) : path } export function delBasePath(path: string): string { return path.slice(basePath.length) || '/' } function prepareRoute(path: string) { return removePathTrailingSlash(delBasePath(path || '/')) } type Url = UrlObject | string function formatUrl(url: Url): string { return url ? formatWithValidation( normalizeTrailingSlash(typeof url === 'object' ? url : parse(url)) ) : url } function prepareUrlAs(url: Url, as: Url) { // If url and as provided as an object representation, // we'll format them into the string version here. return { url: addBasePath(formatUrl(url)), as: as ? addBasePath(formatUrl(as)) : as, } } type ComponentRes = { page: ComponentType; mod: any } export type BaseRouter = { route: string pathname: string query: ParsedUrlQuery asPath: string basePath: string } export type NextRouter = BaseRouter & Pick< Router, | 'push' | 'replace' | 'reload' | 'back' | 'prefetch' | 'beforePopState' | 'events' | 'isFallback' > export type PrefetchOptions = { priority?: boolean } type RouteInfo = { Component: ComponentType __N_SSG?: boolean __N_SSP?: boolean props?: any err?: Error error?: any } type Subscription = (data: RouteInfo, App?: ComponentType) => Promise type BeforePopStateCallback = (state: any) => boolean type ComponentLoadCancel = (() => void) | null type HistoryMethod = 'replaceState' | 'pushState' const manualScrollRestoration = process.env.__NEXT_SCROLL_RESTORATION && typeof window !== 'undefined' && 'scrollRestoration' in window.history function fetchNextData( dataHref: string, isServerRender: boolean, cb?: (...args: any) => any ) { let attempts = isServerRender ? 3 : 1 function getResponse(): Promise { return fetch(dataHref, { // Cookies are required to be present for Next.js' SSG "Preview Mode". // Cookies may also be required for `getServerSideProps`. // // > `fetch` won’t send cookies, unless you set the credentials init // > option. // https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch // // > For maximum browser compatibility when it comes to sending & // > receiving cookies, always supply the `credentials: 'same-origin'` // > option instead of relying on the default. // https://github.com/github/fetch#caveats credentials: 'same-origin', }).then((res) => { if (!res.ok) { if (--attempts > 0 && res.status >= 500) { return getResponse() } throw new Error(`Failed to load static props`) } return res.json() }) } return getResponse() .then((data) => { return cb ? cb(data) : data }) .catch((err: Error) => { // We should only trigger a server-side transition if this was caused // on a client-side transition. Otherwise, we'd get into an infinite // loop. if (!isServerRender) { ;(err as any).code = 'PAGE_LOAD_ERROR' } throw err }) } export default class Router implements BaseRouter { route: string pathname: string query: ParsedUrlQuery asPath: string basePath: string /** * Map of all components loaded in `Router` */ components: { [pathname: string]: RouteInfo } // Static Data Cache sdc: { [asPath: string]: object } = {} sub: Subscription clc: ComponentLoadCancel pageLoader: any _bps: BeforePopStateCallback | undefined events: MittEmitter _wrapApp: (App: ComponentType) => any isSsr: boolean isFallback: boolean static events: MittEmitter = mitt() constructor( pathname: string, query: ParsedUrlQuery, as: string, { initialProps, pageLoader, App, wrapApp, Component, err, subscription, isFallback, }: { subscription: Subscription initialProps: any pageLoader: any Component: ComponentType App: ComponentType wrapApp: (App: ComponentType) => any err?: Error isFallback: boolean } ) { // represents the current component key this.route = removePathTrailingSlash(pathname) // set up the component cache (by route keys) this.components = {} // We should not keep the cache, if there's an error // Otherwise, this cause issues when when going back and // come again to the errored page. if (pathname !== '/_error') { this.components[this.route] = { Component, props: initialProps, err, __N_SSG: initialProps && initialProps.__N_SSG, __N_SSP: initialProps && initialProps.__N_SSP, } } this.components['/_app'] = { Component: App } // Backwards compat for Router.router.events // TODO: Should be remove the following major version as it was never documented this.events = Router.events this.pageLoader = pageLoader this.pathname = pathname this.query = query // if auto prerendered and dynamic route wait to update asPath // until after mount to prevent hydration mismatch this.asPath = // @ts-ignore this is temporarily global (attached to window) isDynamicRoute(pathname) && __NEXT_DATA__.autoExport ? pathname : delBasePath(as) this.basePath = basePath this.sub = subscription this.clc = null this._wrapApp = wrapApp // make sure to ignore extra popState in safari on navigating // back from external site this.isSsr = true this.isFallback = isFallback if (typeof window !== 'undefined') { // make sure "as" doesn't start with double slashes or else it can // throw an error as it's considered invalid if (as.substr(0, 2) !== '//') { // in order for `e.state` to work on the `onpopstate` event // we have to register the initial route upon initialization this.changeState( 'replaceState', formatWithValidation({ pathname: addBasePath(pathname), query }), getURL() ) } window.addEventListener('popstate', this.onPopState) // enable custom scroll restoration handling when available // otherwise fallback to browser's default handling if (process.env.__NEXT_SCROLL_RESTORATION) { if (manualScrollRestoration) { window.history.scrollRestoration = 'manual' let scrollDebounceTimeout: undefined | NodeJS.Timeout const debouncedScrollSave = () => { if (scrollDebounceTimeout) clearTimeout(scrollDebounceTimeout) scrollDebounceTimeout = setTimeout(() => { const { url, as: curAs, options } = history.state this.changeState( 'replaceState', url, curAs, Object.assign({}, options, { _N_X: window.scrollX, _N_Y: window.scrollY, }) ) }, 10) } window.addEventListener('scroll', debouncedScrollSave) } } } } // @deprecated backwards compatibility even though it's a private method. static _rewriteUrlForNextExport(url: string): string { if (process.env.__NEXT_EXPORT_TRAILING_SLASH) { const rewriteUrlForNextExport = require('./rewrite-url-for-export') .rewriteUrlForNextExport return rewriteUrlForNextExport(url) } else { return url } } onPopState = (e: PopStateEvent): void => { if (!e.state) { // We get state as undefined for two reasons. // 1. With older safari (< 8) and older chrome (< 34) // 2. When the URL changed with # // // In the both cases, we don't need to proceed and change the route. // (as it's already changed) // But we can simply replace the state with the new changes. // Actually, for (1) we don't need to nothing. But it's hard to detect that event. // So, doing the following for (1) does no harm. const { pathname, query } = this this.changeState( 'replaceState', formatWithValidation({ pathname: addBasePath(pathname), query }), getURL() ) return } // Make sure we don't re-render on initial load, // can be caused by navigating back from an external site if ( e.state && this.isSsr && e.state.as === this.asPath && parse(e.state.url).pathname === this.pathname ) { return } // If the downstream application returns falsy, return. // They will then be responsible for handling the event. if (this._bps && !this._bps(e.state)) { return } const { url, as, options } = e.state if (process.env.NODE_ENV !== 'production') { if (typeof url === 'undefined' || typeof as === 'undefined') { console.warn( '`popstate` event triggered but `event.state` did not have `url` or `as` https://err.sh/vercel/next.js/popstate-state-empty' ) } } this.change('replaceState', url, as, options) } update(route: string, mod: any) { const Component: ComponentType = mod.default || mod const data = this.components[route] if (!data) { throw new Error(`Cannot update unavailable route: ${route}`) } const newData = Object.assign({}, data, { Component, __N_SSG: mod.__N_SSG, __N_SSP: mod.__N_SSP, }) this.components[route] = newData // pages/_app.js updated if (route === '/_app') { this.notify(this.components[this.route]) return } if (route === this.route) { this.notify(newData) } } reload(): void { window.location.reload() } /** * Go back in history */ back() { window.history.back() } /** * Performs a `pushState` with arguments * @param url of the route * @param as masks `url` for the browser * @param options object you can define `shallow` and other options */ push(url: Url, as: Url = url, options = {}) { ;({ url, as } = prepareUrlAs(url, as)) return this.change('pushState', url, as, options) } /** * Performs a `replaceState` with arguments * @param url of the route * @param as masks `url` for the browser * @param options object you can define `shallow` and other options */ replace(url: Url, as: Url = url, options = {}) { ;({ url, as } = prepareUrlAs(url, as)) return this.change('replaceState', url, as, options) } change( method: HistoryMethod, url: string, as: string, options: any ): Promise { return new Promise((resolve, reject) => { if (!options._h) { this.isSsr = false } // marking route changes as a navigation start entry if (ST) { performance.mark('routeChange') } // Add the ending slash to the paths. So, we can serve the // "/index.html" directly for the SSR page. if (process.env.__NEXT_EXPORT_TRAILING_SLASH) { const rewriteUrlForNextExport = require('./rewrite-url-for-export') .rewriteUrlForNextExport // @ts-ignore this is temporarily global (attached to window) if (__NEXT_DATA__.nextExport) { as = rewriteUrlForNextExport(as) } } this.abortComponentLoad(as) // If the url change is only related to a hash change // We should not proceed. We should only change the state. // WARNING: `_h` is an internal option for handing Next.js client-side // hydration. Your app should _never_ use this property. It may change at // any time without notice. if (!options._h && this.onlyAHashChange(as)) { this.asPath = as Router.events.emit('hashChangeStart', as) this.changeState(method, url, as, options) this.scrollToHash(as) Router.events.emit('hashChangeComplete', as) return resolve(true) } let { pathname, query, protocol } = parse(url, true) // url and as should always be prefixed with basePath by this // point by either next/link or router.push/replace so strip the // basePath from the pathname to match the pages dir 1-to-1 pathname = pathname ? removePathTrailingSlash(delBasePath(pathname)) : pathname if (!pathname || protocol) { if (process.env.NODE_ENV !== 'production') { throw new Error( `Invalid href passed to router: ${url} https://err.sh/vercel/next.js/invalid-href-passed` ) } return resolve(false) } const cleanedAs = delBasePath(as) // If asked to change the current URL we should reload the current page // (not location.reload() but reload getInitialProps and other Next.js stuffs) // We also need to set the method = replaceState always // as this should not go into the history (That's how browsers work) // We should compare the new asPath to the current asPath, not the url if (!this.urlIsNew(cleanedAs)) { method = 'replaceState' } const route = removePathTrailingSlash(pathname) const { shallow = false } = options if (isDynamicRoute(route)) { const { pathname: asPathname } = parse(cleanedAs) const routeRegex = getRouteRegex(route) const routeMatch = getRouteMatcher(routeRegex)(asPathname) if (!routeMatch) { const missingParams = Object.keys(routeRegex.groups).filter( (param) => !query[param] ) if (missingParams.length > 0) { if (process.env.NODE_ENV !== 'production') { console.warn( `Mismatching \`as\` and \`href\` failed to manually provide ` + `the params: ${missingParams.join( ', ' )} in the \`href\`'s \`query\`` ) } return reject( new Error( `The provided \`as\` value (${asPathname}) is incompatible with the \`href\` value (${route}). ` + `Read more: https://err.sh/vercel/next.js/incompatible-href-as` ) ) } } else { // Merge params into `query`, overwriting any specified in search Object.assign(query, routeMatch) } } Router.events.emit('routeChangeStart', as) // If shallow is true and the route exists in the router cache we reuse the previous result this.getRouteInfo(route, pathname, query, as, shallow).then( (routeInfo) => { const { error } = routeInfo if (error && error.cancelled) { return resolve(false) } Router.events.emit('beforeHistoryChange', as) this.changeState(method, url, as, options) if (process.env.NODE_ENV !== 'production') { const appComp: any = this.components['/_app'].Component ;(window as any).next.isPrerendered = appComp.getInitialProps === appComp.origGetInitialProps && !(routeInfo.Component as any).getInitialProps } this.set(route, pathname!, query, cleanedAs, routeInfo).then(() => { if (error) { Router.events.emit('routeChangeError', error, as) throw error } if (process.env.__NEXT_SCROLL_RESTORATION) { if (manualScrollRestoration && '_N_X' in options) { window.scrollTo(options._N_X, options._N_Y) } } Router.events.emit('routeChangeComplete', as) return resolve(true) }) }, reject ) }) } changeState( method: HistoryMethod, url: string, as: string, options = {} ): void { if (process.env.NODE_ENV !== 'production') { if (typeof window.history === 'undefined') { console.error(`Warning: window.history is not available.`) return } if (typeof window.history[method] === 'undefined') { console.error(`Warning: window.history.${method} is not available`) return } } if (method !== 'pushState' || getURL() !== as) { window.history[method]( { url, as, options, }, // Most browsers currently ignores this parameter, although they may use it in the future. // Passing the empty string here should be safe against future changes to the method. // https://developer.mozilla.org/en-US/docs/Web/API/History/replaceState '', as ) } } getRouteInfo( route: string, pathname: string, query: any, as: string, shallow: boolean = false ): Promise { const cachedRouteInfo = this.components[route] // If there is a shallow route transition possible // If the route is already rendered on the screen. if (shallow && cachedRouteInfo && this.route === route) { return Promise.resolve(cachedRouteInfo) } const handleError = ( err: Error & { code: any; cancelled: boolean }, loadErrorFail?: boolean ) => { return new Promise((resolve) => { if (err.code === 'PAGE_LOAD_ERROR' || loadErrorFail) { // If we can't load the page it could be one of following reasons // 1. Page doesn't exists // 2. Page does exist in a different zone // 3. Internal error while loading the page // So, doing a hard reload is the proper way to deal with this. window.location.href = as // Changing the URL doesn't block executing the current code path. // So, we need to mark it as a cancelled error and stop the routing logic. err.cancelled = true // @ts-ignore TODO: fix the control flow here return resolve({ error: err }) } if (err.cancelled) { // @ts-ignore TODO: fix the control flow here return resolve({ error: err }) } resolve( this.fetchComponent('/_error') .then((res) => { const { page: Component } = res const routeInfo: RouteInfo = { Component, err } return new Promise((resolveRouteInfo) => { this.getInitialProps(Component, { err, pathname, query, } as any).then( (props) => { routeInfo.props = props routeInfo.error = err resolveRouteInfo(routeInfo) }, (gipErr) => { console.error( 'Error in error page `getInitialProps`: ', gipErr ) routeInfo.error = err routeInfo.props = {} resolveRouteInfo(routeInfo) } ) }) as Promise }) .catch((routeInfoErr) => handleError(routeInfoErr, true)) ) }) as Promise } return (new Promise((resolve, reject) => { if (cachedRouteInfo) { return resolve(cachedRouteInfo) } this.fetchComponent(route).then( (res) => resolve({ Component: res.page, __N_SSG: res.mod.__N_SSG, __N_SSP: res.mod.__N_SSP, }), reject ) }) as Promise) .then((routeInfo: RouteInfo) => { const { Component, __N_SSG, __N_SSP } = routeInfo if (process.env.NODE_ENV !== 'production') { const { isValidElementType } = require('react-is') if (!isValidElementType(Component)) { throw new Error( `The default export is not a React Component in page: "${pathname}"` ) } } let dataHref: string | undefined if (__N_SSG || __N_SSP) { dataHref = this.pageLoader.getDataHref( formatWithValidation({ pathname, query }), as, __N_SSG ) } return this._getData(() => __N_SSG ? this._getStaticData(dataHref!) : __N_SSP ? this._getServerData(dataHref!) : this.getInitialProps( Component, // we provide AppTree later so this needs to be `any` { pathname, query, asPath: as, } as any ) ).then((props) => { routeInfo.props = props this.components[route] = routeInfo return routeInfo }) }) .catch(handleError) } set( route: string, pathname: string, query: any, as: string, data: RouteInfo ): Promise { this.isFallback = false this.route = route this.pathname = pathname this.query = query this.asPath = as return this.notify(data) } /** * Callback to execute before replacing router state * @param cb callback to be executed */ beforePopState(cb: BeforePopStateCallback) { this._bps = cb } onlyAHashChange(as: string): boolean { if (!this.asPath) return false const [oldUrlNoHash, oldHash] = this.asPath.split('#') const [newUrlNoHash, newHash] = as.split('#') // Makes sure we scroll to the provided hash if the url/hash are the same if (newHash && oldUrlNoHash === newUrlNoHash && oldHash === newHash) { return true } // If the urls are change, there's more than a hash change if (oldUrlNoHash !== newUrlNoHash) { return false } // If the hash has changed, then it's a hash only change. // This check is necessary to handle both the enter and // leave hash === '' cases. The identity case falls through // and is treated as a next reload. return oldHash !== newHash } scrollToHash(as: string): void { const [, hash] = as.split('#') // Scroll to top if the hash is just `#` with no value if (hash === '') { window.scrollTo(0, 0) return } // First we check if the element by id is found const idEl = document.getElementById(hash) if (idEl) { idEl.scrollIntoView() return } // If there's no element with the id, we check the `name` property // To mirror browsers const nameEl = document.getElementsByName(hash)[0] if (nameEl) { nameEl.scrollIntoView() } } urlIsNew(asPath: string): boolean { return this.asPath !== asPath } /** * Prefetch page code, you may wait for the data during page rendering. * This feature only works in production! * @param url the href of prefetched page * @param asPath the as path of the prefetched page */ prefetch( url: string, asPath: string = url, options: PrefetchOptions = {} ): Promise { return new Promise((resolve, reject) => { const { pathname, protocol } = parse(url) if (!pathname || protocol) { if (process.env.NODE_ENV !== 'production') { throw new Error( `Invalid href passed to router: ${url} https://err.sh/vercel/next.js/invalid-href-passed` ) } return } // Prefetch is not supported in development mode because it would trigger on-demand-entries if (process.env.NODE_ENV !== 'production') { return } const route = removePathTrailingSlash(pathname) Promise.all([ this.pageLoader.prefetchData(url, asPath), this.pageLoader[options.priority ? 'loadPage' : 'prefetch'](route), ]).then(() => resolve(), reject) }) } async fetchComponent(route: string): Promise { let cancelled = false const cancel = (this.clc = () => { cancelled = true }) const componentResult = await this.pageLoader.loadPage(route) if (cancelled) { const error: any = new Error( `Abort fetching component for route: "${route}"` ) error.cancelled = true throw error } if (cancel === this.clc) { this.clc = null } return componentResult } _getData(fn: () => Promise): Promise { let cancelled = false const cancel = () => { cancelled = true } this.clc = cancel return fn().then((data) => { if (cancel === this.clc) { this.clc = null } if (cancelled) { const err: any = new Error('Loading initial props cancelled') err.cancelled = true throw err } return data }) } _getStaticData = (dataHref: string): Promise => { const pathname = prepareRoute(parse(dataHref).pathname!) return process.env.NODE_ENV === 'production' && this.sdc[pathname] ? Promise.resolve(this.sdc[dataHref]) : fetchNextData( dataHref, this.isSsr, (data) => (this.sdc[pathname] = data) ) } _getServerData = (dataHref: string): Promise => { return fetchNextData(dataHref, this.isSsr) } getInitialProps( Component: ComponentType, ctx: NextPageContext ): Promise { const { Component: App } = this.components['/_app'] const AppTree = this._wrapApp(App) ctx.AppTree = AppTree return loadGetInitialProps>(App, { AppTree, Component, router: this, ctx, }) } abortComponentLoad(as: string): void { if (this.clc) { const e = new Error('Route Cancelled') ;(e as any).cancelled = true Router.events.emit('routeChangeError', e, as) this.clc() this.clc = null } } notify(data: RouteInfo): Promise { return this.sub(data, this.components['/_app'].Component) } }