forked from MapComplete/MapComplete
		
	
		
			
				
	
	
		
			138 lines
		
	
	
	
		
			4.2 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
			
		
		
	
	
			138 lines
		
	
	
	
		
			4.2 KiB
		
	
	
	
		
			TypeScript
		
	
	
	
	
	
import { exec } from "child_process"
 | 
						|
import { describe, it } from "vitest"
 | 
						|
 | 
						|
import { parse as parse_html } from "node-html-parser"
 | 
						|
import { readFileSync } from "fs"
 | 
						|
import ScriptUtils from "../scripts/ScriptUtils"
 | 
						|
 | 
						|
/**
 | 
						|
 *
 | 
						|
 * @param forbidden: a GREP-regex. This means that '.' is a wildcard and should be escaped to match a literal dot
 | 
						|
 * @param reason
 | 
						|
 * @private
 | 
						|
 */
 | 
						|
function detectInCode(forbidden: string, reason: string): Promise<void> {
 | 
						|
    return new Promise<void>((done) => {
 | 
						|
        const excludedDirs = [
 | 
						|
            ".git",
 | 
						|
            "node_modules",
 | 
						|
            "dist",
 | 
						|
            ".cache",
 | 
						|
            ".parcel-cache",
 | 
						|
            "assets",
 | 
						|
            "vendor",
 | 
						|
            ".idea/",
 | 
						|
        ]
 | 
						|
 | 
						|
        exec(
 | 
						|
            'grep -n "' +
 | 
						|
                forbidden +
 | 
						|
                '" -r . ' +
 | 
						|
                excludedDirs.map((d) => "--exclude-dir=" + d).join(" "),
 | 
						|
            (error, stdout, stderr) => {
 | 
						|
                if (error?.message?.startsWith("Command failed: grep")) {
 | 
						|
                    console.warn("Command failed!", error)
 | 
						|
                    return
 | 
						|
                }
 | 
						|
                if (error !== null) {
 | 
						|
                    throw error
 | 
						|
                }
 | 
						|
                if (stderr !== "") {
 | 
						|
                    throw stderr
 | 
						|
                }
 | 
						|
 | 
						|
                const found = stdout
 | 
						|
                    .split("\n")
 | 
						|
                    .filter((s) => s !== "")
 | 
						|
                    .filter((s) => !s.startsWith("./test/"))
 | 
						|
                if (found.length > 0) {
 | 
						|
                    const msg = `Found a '${forbidden}' at \n    ${found.join(
 | 
						|
                        "\n     "
 | 
						|
                    )}.\n ${reason}`
 | 
						|
                    console.error(msg)
 | 
						|
                    console.error(found.length, "issues found")
 | 
						|
                    throw msg
 | 
						|
                }
 | 
						|
            }
 | 
						|
        )
 | 
						|
    })
 | 
						|
}
 | 
						|
 | 
						|
function wrap(promise: Promise<void>): (done: () => void) => void {
 | 
						|
    return (done) => {
 | 
						|
        promise.then(done)
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
function itAsync(name: string, promise: Promise<void>) {
 | 
						|
    it(name, wrap(promise))
 | 
						|
}
 | 
						|
 | 
						|
function validateScriptIntegrityOf(path: string) {
 | 
						|
    const htmlContents = readFileSync(path, "utf8")
 | 
						|
    const doc = parse_html(htmlContents)
 | 
						|
    // @ts-ignore
 | 
						|
    const scripts = Array.from(doc.getElementsByTagName("script"))
 | 
						|
    for (const script of scripts) {
 | 
						|
        const src = script.getAttribute("src")
 | 
						|
        if (src === undefined) {
 | 
						|
            continue
 | 
						|
        }
 | 
						|
        if (src.startsWith("./")) {
 | 
						|
            // Local script - no check needed
 | 
						|
            continue
 | 
						|
        }
 | 
						|
        const integrity = script.getAttribute("integrity")
 | 
						|
        const ctx = "Script with source " + src + " in file " + path
 | 
						|
        if (integrity === undefined) {
 | 
						|
            throw new Error(ctx + " has no integrity value")
 | 
						|
        }
 | 
						|
        const crossorigin = script.getAttribute("crossorigin")
 | 
						|
        if (crossorigin !== "anonymous") {
 | 
						|
            throw new Error(ctx + " has crossorigin missing or not set to 'anonymous'")
 | 
						|
        }
 | 
						|
    }
 | 
						|
}
 | 
						|
 | 
						|
describe("Code quality", () => {
 | 
						|
    itAsync(
 | 
						|
        "should not contain reverse",
 | 
						|
        detectInCode(
 | 
						|
            "reverse()",
 | 
						|
            "Reverse is stateful and changes the source list. This often causes subtle bugs"
 | 
						|
        )
 | 
						|
    )
 | 
						|
 | 
						|
    itAsync(
 | 
						|
        "should not contain 'constructor.name'",
 | 
						|
        detectInCode("constructor\\.name", "This is not allowed, as minification does erase names.")
 | 
						|
    )
 | 
						|
 | 
						|
    itAsync(
 | 
						|
        "should not contain 'innerText'",
 | 
						|
        detectInCode(
 | 
						|
            "innerText",
 | 
						|
            "innerText is not allowed as it is not testable with fakeDom. Use 'textContent' instead."
 | 
						|
        )
 | 
						|
    )
 | 
						|
 | 
						|
    it("scripts with external sources should have an integrity hash", () => {
 | 
						|
        const htmlFiles = ScriptUtils.readDirRecSync(".", 1).filter((f) => f.endsWith(".html"))
 | 
						|
        for (const htmlFile of htmlFiles) {
 | 
						|
            validateScriptIntegrityOf(htmlFile)
 | 
						|
        }
 | 
						|
    })
 | 
						|
    /*
 | 
						|
  itAsync(
 | 
						|
      "should not contain 'import * as name from \"xyz.json\"'",
 | 
						|
      detectInCode(
 | 
						|
          'import \\* as [a-zA-Z0-9_]\\+ from \\"[.-_/a-zA-Z0-9]\\+\\.json\\"',
 | 
						|
          "With vite, json files have a default export. Use import name from file.json instead"
 | 
						|
      )
 | 
						|
  )
 | 
						|
/*
 | 
						|
  itAsync(
 | 
						|
      "should not contain '[\"default\"]'",
 | 
						|
      detectInCode('\\[\\"default\\"\\]', "Possible leftover of faulty default import")
 | 
						|
  )*/
 | 
						|
})
 |