@aref-shojaei/router 1.0.2 → 1.1.0

package/src/utils/selector.js

@@ -1,60 +1,60 @@
-import { InvalidArgumentTypeError } from "../exception.js"
-
-/**
- * @abstract
- */
-export default class Selector {
-    static #elements = []
-
-
-    constructor() {
-        throw new Error(`${new.target.name} class must not be called with \"new\" keyword!`)
-    }
-
-    /**
-     * @param {HTMLAnchorElement} element 
-     * @param {Document} document 
-     * @returns {Selector}
-     */
-    static findAll(element, document) {
-        if (typeof element !== "string") throw new InvalidArgumentTypeError("'element' must be an HTMLElement object!")
-
-        if (typeof document !== "object") throw new InvalidArgumentTypeError("'document' must be a Document object!")
-
-
-        const elements = document.querySelectorAll(element)
-        
-        this._setElements(elements)
-
-        return this
-    }
-
-    /**
-     * @param {function} callback
-     * @returns {void}
-     * @returns {void}
-     */
-    static each(callback) {
-        if (typeof callback !== "function") throw new InvalidArgumentTypeError("'callback' must be a function!")
-
-
-        const elements = this._getElements()
-
-        if (this.#elements.length) elements.forEach(callback)
-    }
-
-    /**
-     * @param {array} elements 
-     * @returns {void}
-     */
-    static _setElements(elements) {
-        this.#elements.push(...elements)
-    }
-
-    /**
-     * @returns {array}
-     */
-    static _getElements() {
-        return this.#elements
-    }
+import { InvalidArgumentTypeError } from "../exception.js"
+
+/**
+ * @abstract
+ */
+export default class Selector {
+    static #elements = []
+
+
+    constructor() {
+        throw new Error(`${new.target.name} class must not be called with \"new\" keyword!`)
+    }
+
+    /**
+     * @param {HTMLAnchorElement} element 
+     * @param {Document} document 
+     * @returns {Selector}
+     */
+    static findAll(element, document) {
+        if (typeof element !== "string") throw new InvalidArgumentTypeError("'element' must be an HTMLElement object!")
+
+        if (typeof document !== "object") throw new InvalidArgumentTypeError("'document' must be a Document object!")
+
+
+        const elements = document.querySelectorAll(element)
+        
+        this._setElements(elements)
+
+        return this
+    }
+
+    /**
+     * @param {function} callback
+     * @returns {void}
+     * @returns {void}
+     */
+    static each(callback) {
+        if (typeof callback !== "function") throw new InvalidArgumentTypeError("'callback' must be a function!")
+
+
+        const elements = this._getElements()
+
+        if (this.#elements.length) elements.forEach(callback)
+    }
+
+    /**
+     * @param {array} elements 
+     * @returns {void}
+     */
+    static _setElements(elements) {
+        this.#elements.push(...elements)
+    }
+
+    /**
+     * @returns {array}
+     */
+    static _getElements() {
+        return this.#elements
+    }
 }

package/src/view.js

@@ -1,25 +1,25 @@
-import { InvalidArgumentTypeError } from "./exception.js"
-
-/**
- * @abstract
- */
-export default class View {
-    constructor() {
-        throw new Error(`${new.target.name} class must not be called with \"new\" keyword!`)
-    }
-
-    /**
-     * @param {function} template 
-     * @param {object} data 
-     * @returns {string}
-     */
-    static render(template, data = {}) {
-        if (typeof template !== "function") throw new InvalidArgumentTypeError("'template' must be a function!")
-
-        try {
-            return template(data)
-        } catch (error) {
-            console.error("Error during template rendering: ", error);            
-        }
-    }
+import { InvalidArgumentTypeError } from "./exception.js"
+
+/**
+ * @abstract
+ */
+export default class View {
+    constructor() {
+        throw new Error(`${new.target.name} class must not be called with \"new\" keyword!`)
+    }
+
+    /**
+     * @param {function} template 
+     * @param {object} data 
+     * @returns {string}
+     */
+    static render(template, data = {}) {
+        if (typeof template !== "function") throw new InvalidArgumentTypeError("'template' must be a function!")
+
+        try {
+            return template(data)
+        } catch (error) {
+            console.error("Error during template rendering: ", error);            
+        }
+    }
 }

package/tests/unit/element.test.js

@@ -1,33 +1,33 @@
-import { JSDOM } from "jsdom"
-import Element from "../../src/utils/element"
-
-
-describe("Element tests", () => {
-    let documentInstance
-
-    beforeEach(() => {
-        const { window : { document } } = new JSDOM(`
-            <html>
-                <head>
-                    <title>SPA Page</title>
-                </head>
-                <body>
-                    <a href='/'>Home page</a>
-                </body>
-            </html>
-        `)
-
-        documentInstance = document
-    })
-
-
-    it("should prevent instantiation of the class", () => {
-        expect(() => new Element).toThrow()
-    })
-
-    it("should fire click event", () => {
-        const link = documentInstance.querySelector("a")
-
-        Element.onClick(link , (event) => expect(typeof event).toBe(Event))
-    })
+import { JSDOM } from "jsdom"
+import Element from "../../src/utils/element"
+
+
+describe("Element tests", () => {
+    let documentInstance
+
+    beforeEach(() => {
+        const { window : { document } } = new JSDOM(`
+            <html>
+                <head>
+                    <title>SPA Page</title>
+                </head>
+                <body>
+                    <a href='/'>Home page</a>
+                </body>
+            </html>
+        `)
+
+        documentInstance = document
+    })
+
+
+    it("should prevent instantiation of the class", () => {
+        expect(() => new Element).toThrow()
+    })
+
+    it("should fire click event", () => {
+        const link = documentInstance.querySelector("a")
+
+        Element.onClick(link , (event) => expect(typeof event).toBe(Event))
+    })
 })

package/tests/unit/page.test.js

@@ -1,49 +1,49 @@
-import { JSDOM } from "jsdom"
-import Page from "../../src/page.js" 
-
-
-describe("Page tests", () => {
-    let documentInstance
-    const titles = {
-        default : "SPA Page",
-        custom : "Custom Page",
-    }
-
-    beforeEach(() => {
-        const { window : { document } } = new JSDOM(`
-            <html>
-                <head>
-                    <title>${titles["default"]}</title>
-                </head>
-                <body>
-                    <a href='/'>Home page</a>
-                </body>
-            </html>
-        `)
-    
-        documentInstance = document
-
-        Page.setDocument(documentInstance)
-    })
-
-
-    it("should prevent instantiation of the class", () => {
-        expect(() => new Page).toThrow()
-    })
-
-    it("should set page default title", () => {
-        Page.setRootTitle(documentInstance.title)
-
-        expect(Page.getRootTitle()).toBeDefined()
-        expect(Page.getRootTitle()).toBe(titles["default"])
-        expect(typeof Page.getRootTitle()).toBe("string")
-    })
- 
-    it("should set custom page title", () => {
-        Page.setTitle(titles["custom"])
-
-        expect(Page.getTitle()).toBeDefined()
-        expect(Page.getTitle()).toBe(titles["custom"])
-        expect(typeof Page.getTitle()).toBe("string")
-    })
+import { JSDOM } from "jsdom"
+import Page from "../../src/page.js" 
+
+
+describe("Page tests", () => {
+    let documentInstance
+    const titles = {
+        default : "SPA Page",
+        custom : "Custom Page",
+    }
+
+    beforeEach(() => {
+        const { window : { document } } = new JSDOM(`
+            <html>
+                <head>
+                    <title>${titles["default"]}</title>
+                </head>
+                <body>
+                    <a href='/'>Home page</a>
+                </body>
+            </html>
+        `)
+    
+        documentInstance = document
+
+        Page.setDocument(documentInstance)
+    })
+
+
+    it("should prevent instantiation of the class", () => {
+        expect(() => new Page).toThrow()
+    })
+
+    it("should set page default title", () => {
+        Page.setRootTitle(documentInstance.title)
+
+        expect(Page.getRootTitle()).toBeDefined()
+        expect(Page.getRootTitle()).toBe(titles["default"])
+        expect(typeof Page.getRootTitle()).toBe("string")
+    })
+ 
+    it("should set custom page title", () => {
+        Page.setTitle(titles["custom"])
+
+        expect(Page.getTitle()).toBeDefined()
+        expect(Page.getTitle()).toBe(titles["custom"])
+        expect(typeof Page.getTitle()).toBe("string")
+    })
 })

package/tests/unit/route.test.js

@@ -1,83 +1,83 @@
-import Route from "../../src/route.js"
-
-
-describe("Route tests", () => {
-    it("should add a single route", () => {
-        const route = "/"
-        const template = () => "Welcome Page"
-        
-        Route.add(route, template)
-
-        const routes = Route._routes
-
-        expect(routes[route]).toBeDefined()
-    })
-    
-    it("should add the group route", () => {
-        const routePrefix = "/auth"
-        const route = "/login"
-        const template = () => "Login Page"
-        
-        Route.group(routePrefix, () => {
-            Route.add(route, template)
-        })
-
-        const routes = Route._routes
-
-        expect(routes[routePrefix + route]).toBeDefined()
-        expect(typeof routes[routePrefix + route]).toBe("object")
-    })
-    
-    it("should add a dynamic route", () => {
-        const route = "/users/{id}"
-        const template = ({ params: { id } }) => `User #${id}`
-
-        Route.add(route, template)
-
-        const routes = Route._routes
-
-        expect(routes[route]).toBeDefined()
-        expect(typeof routes[route]).toBe("object")
-    })
-    
-    it("should add middleware to a route", () => {
-        const route = "/admin"
-        const template = () => "Admin Page"
-        const loggerMiddleware = () => { message : "Custom Log Message!" } 
-
-        Route.add(route, template).middleware([loggerMiddleware])
-    
-        const routes = Route._routes
-
-        expect(routes[route]["middlewares"]).toBeDefined()
-        expect(typeof routes[route]["middlewares"]).toBe("object")
-    })
-    
-    it("should add page title to a route", () => {
-        const route = "/product"
-        const template = () => "SPA Page"
-
-        Route.add(route, template).title("Custom page title (SPA)")
-    
-        const routes = Route._routes
-
-        expect(routes[route]["title"]).toBeDefined()
-        expect(typeof routes[route]["title"]).toBe("string")
-    })
-    
-    it("should redirect route", () => {
-        const welcomeRoute = "/"
-        const redirectionRoute = "/redirection"
-        const distRoute = welcomeRoute
-
-        Route.add("/", () => "Welcome Page")
-        Route.add("/redirection", () => Route.redirect(distRoute))
-    
-        const routes = Route._routes
-
-        expect(routes[redirectionRoute]).toBeDefined()
-        expect(typeof routes[redirectionRoute]).toBe("object")
-        expect(routes[welcomeRoute]).toBeDefined()
-        expect(typeof routes[welcomeRoute]).toBe("object")
-    })
+import Route from "../../src/route.js"
+
+
+describe("Route tests", () => {
+    it("should add a single route", () => {
+        const route = "/"
+        const template = () => "Welcome Page"
+        
+        Route.add(route, template)
+
+        const routes = Route._routes
+
+        expect(routes[route]).toBeDefined()
+    })
+    
+    it("should add the group route", () => {
+        const routePrefix = "/auth"
+        const route = "/login"
+        const template = () => "Login Page"
+        
+        Route.group(routePrefix, () => {
+            Route.add(route, template)
+        })
+
+        const routes = Route._routes
+
+        expect(routes[routePrefix + route]).toBeDefined()
+        expect(typeof routes[routePrefix + route]).toBe("object")
+    })
+    
+    it("should add a dynamic route", () => {
+        const route = "/users/{id}"
+        const template = ({ params: { id } }) => `User #${id}`
+
+        Route.add(route, template)
+
+        const routes = Route._routes
+
+        expect(routes[route]).toBeDefined()
+        expect(typeof routes[route]).toBe("object")
+    })
+    
+    it("should add middleware to a route", () => {
+        const route = "/admin"
+        const template = () => "Admin Page"
+        const loggerMiddleware = () => { message : "Custom Log Message!" } 
+
+        Route.add(route, template).middleware([loggerMiddleware])
+    
+        const routes = Route._routes
+
+        expect(routes[route]["middlewares"]).toBeDefined()
+        expect(typeof routes[route]["middlewares"]).toBe("object")
+    })
+    
+    it("should add page title to a route", () => {
+        const route = "/product"
+        const template = () => "SPA Page"
+
+        Route.add(route, template).title("Custom page title (SPA)")
+    
+        const routes = Route._routes
+
+        expect(routes[route]["title"]).toBeDefined()
+        expect(typeof routes[route]["title"]).toBe("string")
+    })
+    
+    it("should redirect route", () => {
+        const welcomeRoute = "/"
+        const redirectionRoute = "/redirection"
+        const distRoute = welcomeRoute
+
+        Route.add("/", () => "Welcome Page")
+        Route.add("/redirection", () => Route.redirect(distRoute))
+    
+        const routes = Route._routes
+
+        expect(routes[redirectionRoute]).toBeDefined()
+        expect(typeof routes[redirectionRoute]).toBe("object")
+        expect(routes[welcomeRoute]).toBeDefined()
+        expect(typeof routes[welcomeRoute]).toBe("object")
+    })
 })

package/tests/unit/router.test.js

@@ -1,56 +1,56 @@
-import { JSDOM } from "jsdom"
-import Router from "../../src/router.js"
-
-
-describe("Router tests", () => {
-    let documentInstance
-    let windowtInstance
-    let selectorID
-
-    beforeEach(() => {
-        const { window } = new JSDOM(`
-            <html>
-                <head>
-                    <title>SPA Page</title>
-                </head>
-                <body>
-                    <div id='root'></div>
-                </body>
-            </html>
-        `)
-
-        const { document } = window
-
-
-        documentInstance = document
-        windowtInstance = window
-        selectorID = "#root"
-    })
-
-
-    it("should prevent instantiation of the class", () => {
-        expect(() => new Router).toThrow()
-    })
-
-    it("should configure router", () => {
-        expect(() => {
-            Router.configure({
-                window : windowtInstance,
-                document : documentInstance,
-                selector : selectorID
-            })
-        }).not.toThrow()
-    })
-
-    it("should run router", () => {
-        expect(() => {
-            Router.configure({
-                window : windowtInstance,
-                document : documentInstance,
-                selector : selectorID
-            })
-    
-            Router.run()
-        }).not.toThrow()
-    })
+import { JSDOM } from "jsdom"
+import Router from "../../src/router.js"
+
+
+describe("Router tests", () => {
+    let documentInstance
+    let windowtInstance
+    let selectorID
+
+    beforeEach(() => {
+        const { window } = new JSDOM(`
+            <html>
+                <head>
+                    <title>SPA Page</title>
+                </head>
+                <body>
+                    <div id='root'></div>
+                </body>
+            </html>
+        `)
+
+        const { document } = window
+
+
+        documentInstance = document
+        windowtInstance = window
+        selectorID = "#root"
+    })
+
+
+    it("should prevent instantiation of the class", () => {
+        expect(() => new Router).toThrow()
+    })
+
+    it("should configure router", () => {
+        expect(() => {
+            Router.configure({
+                window : windowtInstance,
+                document : documentInstance,
+                selector : selectorID
+            })
+        }).not.toThrow()
+    })
+
+    it("should run router", () => {
+        expect(() => {
+            Router.configure({
+                window : windowtInstance,
+                document : documentInstance,
+                selector : selectorID
+            })
+    
+            Router.run()
+        }).not.toThrow()
+    })
 })