/* * Copyright (C) 2021 Aravinth Manivannan * * This program is free software: you can redistribute it and/or modify * it under the terms of the GNU Affero General Public License as * published by the Free Software Foundation, either version 3 of the * License, or (at your option) any later version. * * This program is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * GNU Affero General Public License for more details. * * You should have received a copy of the GNU Affero General Public License * along with this program. If not, see . */ /** Removes trailing slashed from URI */ const normalizeUri = (uri: string) => { if (typeof uri == 'string') { if (uri.trim().length == 0) { throw new Error('uri is empty'); } let uriLength = uri.length; if (uri[uriLength - 1] == '/') { uri = uri.slice(0, uriLength - 1); } return uri; } else { throw new TypeError(`Only strings are permitted in URI`); } }; /** URI<-> Fn mapping type */ type routeTuple = { uri: string; fn: () => void; }; /** * Router that selectively executes fucntions * based on window.location.pathname * */ export class Router { routes: Array; constructor() { this.routes = []; } /** * registers a route-function pair with Router * @param {string} uri - route to be registered * @param {function} fn: - function to be registered when window.locatin.path * matches uri * */ register(uri: string, fn: () => void) { // typechecks if (uri.trim().length == 0) { throw new Error('uri is empty'); } if (typeof uri !== 'string') { throw new TypeError('URI must be a string'); } if (typeof fn !== 'function') { throw new TypeError('a callback fn must be provided'); } uri = normalizeUri(uri); if (this.routes.find(route => { if (route.uri == uri) { return true; } })) { throw new Error('URI exists'); }; const route: routeTuple = { uri, fn, }; this.routes.push(route); } /** * executes registered function with route * matches window.pathname.location * */ route() { const path = normalizeUri(window.location.pathname); this.routes.forEach(route => { const pattern = new RegExp(`^${route.uri}$`); if (path.match(pattern)) { return route.fn(); } }); } }