class App extends Events { _$ = $; _$$ = $$; _page = page; collections = {}; models = {}; templates = {}; views = {}; init() { try { this.initErrorTracking(); } catch (error) {} if (!this.browserCheck()) { return; } this.el = $("._app"); this.localStorage = new LocalStorageStore(); if (app.ServiceWorker.isEnabled()) { this.serviceWorker = new app.ServiceWorker(); } this.settings = new app.Settings(); this.db = new app.DB(); this.settings.initLayout(); this.docs = new app.collections.Docs(); this.disabledDocs = new app.collections.Docs(); this.entries = new app.collections.Entries(); this.router = new app.Router(); this.shortcuts = new app.Shortcuts(); this.document = new app.views.Document(); if (this.isMobile()) { this.mobile = new app.views.Mobile(); } if (document.body.hasAttribute("data-doc")) { this.DOC = JSON.parse(document.body.getAttribute("data-doc")); this.bootOne(); } else if (this.DOCS) { this.bootAll(); } else { this.onBootError(); } } browserCheck() { if (this.isSupportedBrowser()) { return true; } document.body.innerHTML = app.templates.unsupportedBrowser; this.hideLoadingScreen(); return false; } initErrorTracking() { // Show a warning message and don't track errors when the app is loaded // from a domain other than our own, because things are likely to break. // (e.g. cross-domain requests) if (this.isInvalidLocation()) { new app.views.Notif("InvalidLocation"); } else { if (this.config.sentry_dsn) { Raven.config(this.config.sentry_dsn, { release: this.config.release, whitelistUrls: [/devdocs/], includePaths: [/devdocs/], ignoreErrors: [/NPObject/, /NS_ERROR/, /^null$/, /EvalError/], tags: { mode: this.isSingleDoc() ? "single" : "full", iframe: (window.top !== window).toString(), electron: (!!window.process?.versions?.electron).toString(), }, shouldSendCallback: () => { try { if (this.isInjectionError()) { this.onInjectionError(); return false; } if (this.isAndroidWebview()) { return false; } } catch (error) {} return true; }, dataCallback(data) { try { data.user ||= {}; Object.assign(data.user, app.settings.dump()); if (data.user.docs) { data.user.docs = data.user.docs.split("/"); } if (app.lastIDBTransaction) { data.user.lastIDBTransaction = app.lastIDBTransaction; } data.tags.scriptCount = document.scripts.length; } catch (error) {} return data; }, }).install(); } this.previousErrorHandler = onerror; window.onerror = this.onWindowError.bind(this); CookiesStore.onBlocked = this.onCookieBlocked; } } bootOne() { this.doc = new app.models.Doc(this.DOC); this.docs.reset([this.doc]); this.doc.load(this.start.bind(this), this.onBootError.bind(this), { readCache: true, }); new app.views.Notice("singleDoc", this.doc); delete this.DOC; } bootAll() { const docs = this.settings.getDocs(); for (var doc of this.DOCS) { (docs.includes(doc.slug) ? this.docs : this.disabledDocs).add(doc); } this.migrateDocs(); this.docs.load(this.start.bind(this), this.onBootError.bind(this), { readCache: true, writeCache: true, }); delete this.DOCS; } start() { let doc; for (doc of this.docs.all()) { this.entries.add(doc.toEntry()); } for (doc of this.disabledDocs.all()) { this.entries.add(doc.toEntry()); } for (doc of this.docs.all()) { this.initDoc(doc); } this.trigger("ready"); this.router.start(); this.hideLoadingScreen(); setTimeout(() => { if (!this.doc) { this.welcomeBack(); } return this.removeEvent("ready bootError"); }, 50); } initDoc(doc) { for (var type of doc.types.all()) { doc.entries.add(type.toEntry()); } this.entries.add(doc.entries.all()); } migrateDocs() { let needsSaving; for (var slug of this.settings.getDocs()) { if (!this.docs.findBy("slug", slug)) { var doc; needsSaving = true; if (slug === "webpack~2") { doc = this.disabledDocs.findBy("slug", "webpack"); } if (slug === "angular~4_typescript") { doc = this.disabledDocs.findBy("slug", "angular"); } if (slug === "angular~2_typescript") { doc = this.disabledDocs.findBy("slug", "angular~2"); } if (!doc) { doc = this.disabledDocs.findBy("slug_without_version", slug); } if (doc) { this.disabledDocs.remove(doc); this.docs.add(doc); } } } if (needsSaving) { this.saveDocs(); } } enableDoc(doc, _onSuccess, onError) { if (this.docs.contains(doc)) { return; } const onSuccess = () => { if (this.docs.contains(doc)) { return; } this.disabledDocs.remove(doc); this.docs.add(doc); this.docs.sort(); this.initDoc(doc); this.saveDocs(); if (app.settings.get("autoInstall")) { doc.install(_onSuccess, onError); } else { _onSuccess(); } }; doc.load(onSuccess, onError, { writeCache: true }); } saveDocs() { this.settings.setDocs(this.docs.all().map((doc) => doc.slug)); this.db.migrate(); return this.serviceWorker != null ? this.serviceWorker.updateInBackground() : undefined; } welcomeBack() { let visitCount = this.settings.get("count"); this.settings.set("count", ++visitCount); if (visitCount === 5) { new app.views.Notif("Share", { autoHide: null }); } new app.views.News(); new app.views.Updates(); return (this.updateChecker = new app.UpdateChecker()); } reboot() { if (location.pathname !== "/" && location.pathname !== "/settings") { window.location = `/#${location.pathname}`; } else { window.location = "/"; } } reload() { this.docs.clearCache(); this.disabledDocs.clearCache(); if (this.serviceWorker) { this.serviceWorker.reload(); } else { this.reboot(); } } reset() { this.localStorage.reset(); this.settings.reset(); if (this.db != null) { this.db.reset(); } if (this.serviceWorker != null) { this.serviceWorker.update(); } window.location = "/"; } showTip(tip) { if (this.isSingleDoc()) { return; } const tips = this.settings.getTips(); if (!tips.includes(tip)) { tips.push(tip); this.settings.setTips(tips); new app.views.Tip(tip); } } hideLoadingScreen() { if ($.overlayScrollbarsEnabled()) { document.body.classList.add("_overlay-scrollbars"); } document.documentElement.classList.remove("_booting"); } indexHost() { // Can't load the index files from the host/CDN when service worker is // enabled because it doesn't support caching URLs that use CORS. return this.config[ this.serviceWorker && this.settings.hasDocs() ? "index_path" : "docs_origin" ]; } onBootError(...args) { this.trigger("bootError"); this.hideLoadingScreen(); } onQuotaExceeded() { if (this.quotaExceeded) { return; } this.quotaExceeded = true; new app.views.Notif("QuotaExceeded", { autoHide: null }); } onCookieBlocked(key, value, actual) { if (this.cookieBlocked) { return; } this.cookieBlocked = true; new app.views.Notif("CookieBlocked", { autoHide: null }); Raven.captureMessage(`CookieBlocked/${key}`, { level: "warning", extra: { value, actual }, }); } onWindowError(...args) { if (this.cookieBlocked) { return; } if (this.isInjectionError(...args)) { this.onInjectionError(); } else if (this.isAppError(...args)) { if (typeof this.previousErrorHandler === "function") { this.previousErrorHandler(...args); } this.hideLoadingScreen(); if (!this.errorNotif) { this.errorNotif = new app.views.Notif("Error"); } this.errorNotif.show(); } } onInjectionError() { if (!this.injectionError) { this.injectionError = true; alert(`\ JavaScript code has been injected in the page which prevents DevDocs from running correctly. Please check your browser extensions/addons. `); Raven.captureMessage("injection error", { level: "info" }); } } isInjectionError() { // Some browser extensions expect the entire web to use jQuery. // I gave up trying to fight back. return ( window.$ !== app._$ || window.$$ !== app._$$ || window.page !== app._page || typeof $.empty !== "function" || typeof page.show !== "function" ); } isAppError(error, file) { // Ignore errors from external scripts. return file && file.includes("devdocs") && file.endsWith(".js"); } isSupportedBrowser() { try { const features = { bind: !!Function.prototype.bind, pushState: !!history.pushState, matchMedia: !!window.matchMedia, insertAdjacentHTML: !!document.body.insertAdjacentHTML, defaultPrevented: document.createEvent("CustomEvent").defaultPrevented === false, cssVariables: !!CSS.supports?.("(--t: 0)"), }; for (var key in features) { var value = features[key]; if (!value) { Raven.captureMessage(`unsupported/${key}`, { level: "info" }); return false; } } return true; } catch (error) { Raven.captureMessage("unsupported/exception", { level: "info", extra: { error }, }); return false; } } isSingleDoc() { return document.body.hasAttribute("data-doc"); } isMobile() { return this._isMobile != null ? this._isMobile : (this._isMobile = app.views.Mobile.detect()); } isAndroidWebview() { return this._isAndroidWebview != null ? this._isAndroidWebview : (this._isAndroidWebview = app.views.Mobile.detectAndroidWebview()); } isInvalidLocation() { return ( this.config.env === "production" && !location.host.startsWith(app.config.production_host) ); } } this.app = new App();