@slashgear/gdpr-cookie-scanner 3.3.0 → 3.4.0

package/tests/scanner/button-classification.test.ts

@@ -0,0 +1,241 @@
+import { describe, it, expect } from "vitest";
+import { classifyButtonText } from "../../src/scanner/consent-modal.js";
+
+// ── English ───────────────────────────────────────────────────────────────────
+
+describe("classifyButtonText — en", () => {
+  it("accept", () => {
+    expect(classifyButtonText("Accept all", "en")).toBe("accept");
+    expect(classifyButtonText("Agree", "en")).toBe("accept");
+    expect(classifyButtonText("OK", "en")).toBe("accept");
+    expect(classifyButtonText("I accept", "en")).toBe("accept");
+  });
+  it("reject", () => {
+    expect(classifyButtonText("Reject all", "en")).toBe("reject");
+    expect(classifyButtonText("Decline", "en")).toBe("reject");
+    expect(classifyButtonText("No thanks", "en")).toBe("reject");
+    expect(classifyButtonText("Refuse", "en")).toBe("reject");
+  });
+  it("preferences", () => {
+    expect(classifyButtonText("Manage cookies", "en")).toBe("preferences");
+    expect(classifyButtonText("Customize", "en")).toBe("preferences");
+    expect(classifyButtonText("Settings", "en")).toBe("preferences");
+  });
+  it("close", () => {
+    expect(classifyButtonText("Close", "en")).toBe("close");
+  });
+  it("unknown", () => {
+    expect(classifyButtonText("Learn more", "en")).toBe("unknown");
+  });
+});
+
+// ── French ────────────────────────────────────────────────────────────────────
+
+describe("classifyButtonText — fr", () => {
+  it("accept", () => {
+    expect(classifyButtonText("Tout accepter", "fr")).toBe("accept");
+    expect(classifyButtonText("J'accepte", "fr")).toBe("accept");
+    expect(classifyButtonText("Valider", "fr")).toBe("accept");
+  });
+  it("reject", () => {
+    expect(classifyButtonText("Tout refuser", "fr")).toBe("reject");
+    expect(classifyButtonText("Non merci", "fr")).toBe("reject");
+    expect(classifyButtonText("Refus", "fr")).toBe("reject");
+    expect(classifyButtonText("Tout rejeter", "fr")).toBe("reject");
+  });
+  it("preferences", () => {
+    expect(classifyButtonText("Paramètres", "fr")).toBe("preferences");
+    expect(classifyButtonText("Personnaliser", "fr")).toBe("preferences");
+    expect(classifyButtonText("Préférences", "fr")).toBe("preferences");
+  });
+  it("also recognises English labels on a French page (en fallback)", () => {
+    expect(classifyButtonText("Accept all", "fr")).toBe("accept");
+    expect(classifyButtonText("Reject all", "fr")).toBe("reject");
+  });
+});
+
+// ── German ────────────────────────────────────────────────────────────────────
+
+describe("classifyButtonText — de", () => {
+  it("accept", () => {
+    expect(classifyButtonText("Alle akzeptieren", "de")).toBe("accept");
+    expect(classifyButtonText("Zustimmen", "de")).toBe("accept");
+    expect(classifyButtonText("Einverstanden", "de")).toBe("accept");
+  });
+  it("reject", () => {
+    expect(classifyButtonText("Ablehnen", "de")).toBe("reject");
+    expect(classifyButtonText("Alle ablehnen", "de")).toBe("reject");
+    expect(classifyButtonText("Nein danke", "de")).toBe("reject");
+  });
+  it("preferences", () => {
+    expect(classifyButtonText("Einstellungen", "de")).toBe("preferences");
+    expect(classifyButtonText("Anpassen", "de")).toBe("preferences");
+    expect(classifyButtonText("Mehr Optionen", "de")).toBe("preferences");
+  });
+});
+
+// ── Spanish ───────────────────────────────────────────────────────────────────
+
+describe("classifyButtonText — es", () => {
+  it("accept", () => {
+    expect(classifyButtonText("Aceptar todo", "es")).toBe("accept");
+    expect(classifyButtonText("Aceptar", "es")).toBe("accept");
+  });
+  it("reject", () => {
+    expect(classifyButtonText("Rechazar todo", "es")).toBe("reject");
+    expect(classifyButtonText("Rechazar", "es")).toBe("reject");
+    expect(classifyButtonText("No gracias", "es")).toBe("reject");
+  });
+  it("preferences", () => {
+    expect(classifyButtonText("Configurar", "es")).toBe("preferences");
+    expect(classifyButtonText("Preferencias", "es")).toBe("preferences");
+    expect(classifyButtonText("Opciones", "es")).toBe("preferences");
+  });
+});
+
+// ── Italian ───────────────────────────────────────────────────────────────────
+
+describe("classifyButtonText — it", () => {
+  it("accept", () => {
+    expect(classifyButtonText("Accetta tutto", "it")).toBe("accept");
+    expect(classifyButtonText("Accetta", "it")).toBe("accept");
+    expect(classifyButtonText("Acconsento", "it")).toBe("accept");
+  });
+  it("reject", () => {
+    expect(classifyButtonText("Rifiuta tutto", "it")).toBe("reject");
+    expect(classifyButtonText("Rifiuta", "it")).toBe("reject");
+    expect(classifyButtonText("No grazie", "it")).toBe("reject");
+  });
+  it("preferences", () => {
+    expect(classifyButtonText("Impostazioni", "it")).toBe("preferences");
+    expect(classifyButtonText("Gestisci", "it")).toBe("preferences");
+    expect(classifyButtonText("Preferenze", "it")).toBe("preferences");
+  });
+});
+
+// ── Dutch ─────────────────────────────────────────────────────────────────────
+
+describe("classifyButtonText — nl", () => {
+  it("accept", () => {
+    expect(classifyButtonText("Alles accepteren", "nl")).toBe("accept");
+    expect(classifyButtonText("Akkoord", "nl")).toBe("accept");
+  });
+  it("reject", () => {
+    expect(classifyButtonText("Alles weigeren", "nl")).toBe("reject");
+    expect(classifyButtonText("Weigeren", "nl")).toBe("reject");
+    expect(classifyButtonText("Nee bedankt", "nl")).toBe("reject");
+  });
+  it("preferences", () => {
+    expect(classifyButtonText("Instellingen", "nl")).toBe("preferences");
+    expect(classifyButtonText("Voorkeuren", "nl")).toBe("preferences");
+    expect(classifyButtonText("Aanpassen", "nl")).toBe("preferences");
+  });
+});
+
+// ── Polish ────────────────────────────────────────────────────────────────────
+
+describe("classifyButtonText — pl", () => {
+  it("accept", () => {
+    expect(classifyButtonText("Zaakceptuj wszystkie", "pl")).toBe("accept");
+    expect(classifyButtonText("Zaakceptuj", "pl")).toBe("accept");
+    expect(classifyButtonText("Zgadzam się", "pl")).toBe("accept");
+  });
+  it("reject", () => {
+    expect(classifyButtonText("Odrzuć wszystkie", "pl")).toBe("reject");
+    expect(classifyButtonText("Odrzuć", "pl")).toBe("reject");
+    expect(classifyButtonText("Nie zgadzam się", "pl")).toBe("reject");
+  });
+  it("preferences", () => {
+    expect(classifyButtonText("Ustawienia", "pl")).toBe("preferences");
+    expect(classifyButtonText("Dostosuj", "pl")).toBe("preferences");
+    expect(classifyButtonText("Preferencje", "pl")).toBe("preferences");
+  });
+});
+
+// ── Portuguese ────────────────────────────────────────────────────────────────
+
+describe("classifyButtonText — pt", () => {
+  it("accept", () => {
+    expect(classifyButtonText("Aceitar tudo", "pt")).toBe("accept");
+    expect(classifyButtonText("Aceitar", "pt")).toBe("accept");
+    expect(classifyButtonText("Concordo", "pt")).toBe("accept");
+  });
+  it("reject", () => {
+    expect(classifyButtonText("Rejeitar tudo", "pt")).toBe("reject");
+    expect(classifyButtonText("Recusar", "pt")).toBe("reject");
+    expect(classifyButtonText("Não obrigado", "pt")).toBe("reject");
+  });
+  it("preferences", () => {
+    expect(classifyButtonText("Configurações", "pt")).toBe("preferences");
+    expect(classifyButtonText("Preferências", "pt")).toBe("preferences");
+    expect(classifyButtonText("Opções", "pt")).toBe("preferences");
+  });
+});
+
+// ── Unknown / missing language → all patterns tested ─────────────────────────
+
+describe("classifyButtonText — null (unknown language)", () => {
+  it("still classifies common English labels", () => {
+    expect(classifyButtonText("Accept all", null)).toBe("accept");
+    expect(classifyButtonText("Reject all", null)).toBe("reject");
+  });
+  it("still classifies labels from any supported language", () => {
+    expect(classifyButtonText("Alle akzeptieren", null)).toBe("accept");
+    expect(classifyButtonText("Tout refuser", null)).toBe("reject");
+    expect(classifyButtonText("Rifiuta tutto", null)).toBe("reject");
+    expect(classifyButtonText("Odrzuć", null)).toBe("reject");
+  });
+  it("unknown language code falls back to all patterns", () => {
+    expect(classifyButtonText("Accept all", "ro")).toBe("accept");
+    expect(classifyButtonText("Alle akzeptieren", "ro")).toBe("accept");
+  });
+});
+
+// ── BCP 47 subtag normalisation (sanity) ─────────────────────────────────────
+
+describe("classifyButtonText — full BCP 47 tags should be pre-normalised", () => {
+  // The caller (detectConsentModal) splits on "-" and lowercases before passing.
+  // These tests verify "de" (already normalised) matches correctly.
+  it("de matches German patterns", () => {
+    expect(classifyButtonText("Ablehnen", "de")).toBe("reject");
+  });
+  it("fr matches French patterns", () => {
+    expect(classifyButtonText("Tout accepter", "fr")).toBe("accept");
+  });
+});
+
+// ── Whitespace normalisation ──────────────────────────────────────────────────
+
+describe("classifyButtonText — whitespace normalisation", () => {
+  it("collapses embedded newlines (common in CMP HTML templates)", () => {
+    expect(classifyButtonText("Tout\nrefuser", "fr")).toBe("reject");
+    expect(classifyButtonText("Accept\nall", "en")).toBe("accept");
+  });
+
+  it("collapses embedded tabs", () => {
+    expect(classifyButtonText("Reject\tall", "en")).toBe("reject");
+    expect(classifyButtonText("Tout\taccepter", "fr")).toBe("accept");
+  });
+
+  it("replaces non-breaking spaces (\\u00A0 /  ) with regular spaces", () => {
+    expect(classifyButtonText("Tout\u00A0refuser", "fr")).toBe("reject");
+    expect(classifyButtonText("Accept\u00A0all", "en")).toBe("accept");
+    expect(classifyButtonText("Alle\u00A0ablehnen", "de")).toBe("reject");
+  });
+
+  it("collapses multiple consecutive spaces", () => {
+    expect(classifyButtonText("Reject  all", "en")).toBe("reject");
+    expect(classifyButtonText("Tout   accepter", "fr")).toBe("accept");
+  });
+
+  it("strips leading and trailing whitespace", () => {
+    expect(classifyButtonText("  Accept all  ", "en")).toBe("accept");
+    expect(classifyButtonText("\nTout refuser\n", "fr")).toBe("reject");
+  });
+
+  it("handles mixed whitespace characters in a single label", () => {
+    // Real-world CMP buttons sometimes have: icon +   + text + newline
+    expect(classifyButtonText("\n  Tout\u00A0refuser\t", "fr")).toBe("reject");
+    expect(classifyButtonText(" Accept\n\tall ", "en")).toBe("accept");
+  });
+});

package/tests/scanner/contrast-ratio.test.ts

@@ -0,0 +1,172 @@
+import { describe, it, expect } from "vitest";
+import {
+  computeContrastRatio,
+  parseRgb,
+  relativeLuminance,
+} from "../../src/scanner/consent-modal.js";
+
+// ── parseRgb ──────────────────────────────────────────────────────────────────
+
+describe("parseRgb", () => {
+  it("parses rgb() string", () => {
+    expect(parseRgb("rgb(255, 255, 255)")).toEqual([255, 255, 255]);
+    expect(parseRgb("rgb(0, 0, 0)")).toEqual([0, 0, 0]);
+    expect(parseRgb("rgb(100, 150, 200)")).toEqual([100, 150, 200]);
+  });
+
+  it("parses rgba() string, alpha channel is ignored", () => {
+    expect(parseRgb("rgba(0, 0, 0, 0.5)")).toEqual([0, 0, 0]);
+    expect(parseRgb("rgba(255, 255, 255, 1)")).toEqual([255, 255, 255]);
+    expect(parseRgb("rgba(100, 150, 200, 0.8)")).toEqual([100, 150, 200]);
+  });
+
+  it("parses rgba() with no spaces between values", () => {
+    expect(parseRgb("rgba(100,150,200,1)")).toEqual([100, 150, 200]);
+    expect(parseRgb("rgb(0,128,255)")).toEqual([0, 128, 255]);
+  });
+
+  it("parses fully transparent rgba(…,0) — alpha is ignored, RGB is still extracted", () => {
+    // Alpha-zero is treated the same as the opaque colour; callers bear responsibility
+    // for deciding whether to composite against a background.
+    expect(parseRgb("rgba(0, 0, 0, 0)")).toEqual([0, 0, 0]);
+    expect(parseRgb("rgba(255, 255, 255, 0)")).toEqual([255, 255, 255]);
+  });
+
+  it("returns null for named colours (not yet supported)", () => {
+    expect(parseRgb("white")).toBeNull();
+    expect(parseRgb("black")).toBeNull();
+    expect(parseRgb("red")).toBeNull();
+    expect(parseRgb("transparent")).toBeNull();
+  });
+
+  it("returns null for hex colours (not yet supported)", () => {
+    expect(parseRgb("#ffffff")).toBeNull();
+    expect(parseRgb("#000000")).toBeNull();
+    expect(parseRgb("#fff")).toBeNull();
+    expect(parseRgb("#000")).toBeNull();
+  });
+
+  it("returns null for empty string", () => {
+    expect(parseRgb("")).toBeNull();
+  });
+
+  it("returns null for arbitrary unrecognised strings", () => {
+    expect(parseRgb("hsl(0, 0%, 100%)")).toBeNull();
+    expect(parseRgb("oklch(1 0 0)")).toBeNull();
+  });
+});
+
+// ── relativeLuminance ─────────────────────────────────────────────────────────
+
+describe("relativeLuminance", () => {
+  it("returns 0 for black", () => {
+    expect(relativeLuminance([0, 0, 0])).toBe(0);
+  });
+
+  it("returns 1 for white", () => {
+    expect(relativeLuminance([255, 255, 255])).toBe(1);
+  });
+
+  it("returns the WCAG luminance for primary colours", () => {
+    // WCAG 2.x: L = 0.2126·R + 0.7152·G + 0.0722·B (after linearisation)
+    expect(relativeLuminance([255, 0, 0])).toBeCloseTo(0.2126, 4);
+    expect(relativeLuminance([0, 255, 0])).toBeCloseTo(0.7152, 4);
+    expect(relativeLuminance([0, 0, 255])).toBeCloseTo(0.0722, 4);
+  });
+
+  it("uses the linear (÷12.92) branch for very dark channels (s ≤ 0.04045)", () => {
+    // rgb(10,10,10): s = 10/255 ≈ 0.0392 which is ≤ 0.04045 → linear = s/12.92
+    const lum = relativeLuminance([10, 10, 10]);
+    expect(lum).toBeGreaterThan(0);
+    expect(lum).toBeLessThan(0.01);
+  });
+
+  it("uses the gamma branch for mid-to-bright channels (s > 0.04045)", () => {
+    // rgb(128,128,128): s ≈ 0.502 → linear = ((s+0.055)/1.055)^2.4
+    const lum = relativeLuminance([128, 128, 128]);
+    expect(lum).toBeGreaterThan(0.2);
+    expect(lum).toBeLessThan(0.22);
+  });
+
+  it("luminance is symmetric — grey RGB channels give equal weights", () => {
+    // For equal R/G/B channels the contributions must sum correctly
+    const lum = relativeLuminance([200, 200, 200]);
+    const single = relativeLuminance([200, 0, 0]);
+    // luminance(200,200,200) ≈ luminance(200,0,0) × (0.2126+0.7152+0.0722)/0.2126
+    // i.e. the sum of channel weights = 1
+    expect(lum / single).toBeCloseTo(1 / 0.2126, 1);
+  });
+});
+
+// ── computeContrastRatio ──────────────────────────────────────────────────────
+
+describe("computeContrastRatio", () => {
+  it("returns 21 for pure black on pure white (maximum contrast)", () => {
+    expect(computeContrastRatio("rgb(0, 0, 0)", "rgb(255, 255, 255)")).toBe(21);
+  });
+
+  it("is symmetric — order of fg/bg does not change the result", () => {
+    const fwb = computeContrastRatio("rgb(255, 255, 255)", "rgb(0, 0, 0)");
+    const bww = computeContrastRatio("rgb(0, 0, 0)", "rgb(255, 255, 255)");
+    expect(fwb).toBe(bww);
+    expect(fwb).toBe(21);
+  });
+
+  it("returns 1 for identical colours (minimum contrast)", () => {
+    expect(computeContrastRatio("rgb(255, 255, 255)", "rgb(255, 255, 255)")).toBe(1);
+    expect(computeContrastRatio("rgb(0, 0, 0)", "rgb(0, 0, 0)")).toBe(1);
+    expect(computeContrastRatio("rgb(128, 64, 32)", "rgb(128, 64, 32)")).toBe(1);
+  });
+
+  it("result is always ≥ 1 for any two parseable colours", () => {
+    const pairs: [string, string][] = [
+      ["rgb(255, 0, 0)", "rgb(0, 0, 255)"],
+      ["rgb(200, 200, 200)", "rgb(100, 100, 100)"],
+      ["rgb(50, 200, 50)", "rgb(200, 50, 200)"],
+    ];
+    for (const [fg, bg] of pairs) {
+      const r = computeContrastRatio(fg, bg);
+      expect(r).not.toBeNull();
+      expect(r!).toBeGreaterThanOrEqual(1);
+    }
+  });
+
+  it("result is always ≤ 21 (maximum possible WCAG contrast)", () => {
+    expect(computeContrastRatio("rgb(0, 0, 0)", "rgb(255, 255, 255)")).toBe(21);
+  });
+
+  it("result is rounded to at most 2 decimal places", () => {
+    const ratio = computeContrastRatio("rgb(100, 100, 100)", "rgb(200, 200, 200)");
+    expect(ratio).not.toBeNull();
+    // The value must equal its own 2-decimal rounded form
+    expect(ratio).toBe(parseFloat(ratio!.toFixed(2)));
+  });
+
+  it("returns null when fg colour is unparseable", () => {
+    expect(computeContrastRatio("white", "rgb(0, 0, 0)")).toBeNull();
+    expect(computeContrastRatio("#fff", "rgb(0, 0, 0)")).toBeNull();
+    expect(computeContrastRatio("transparent", "rgb(0, 0, 0)")).toBeNull();
+  });
+
+  it("returns null when bg colour is unparseable", () => {
+    expect(computeContrastRatio("rgb(0, 0, 0)", "black")).toBeNull();
+    expect(computeContrastRatio("rgb(0, 0, 0)", "#000000")).toBeNull();
+  });
+
+  it("returns null when both colours are unparseable", () => {
+    expect(computeContrastRatio("white", "black")).toBeNull();
+    expect(computeContrastRatio("#fff", "#000")).toBeNull();
+    expect(computeContrastRatio("transparent", "transparent")).toBeNull();
+  });
+
+  it("transparent rgba(…,0) is treated as its opaque counterpart — alpha is ignored", () => {
+    // This is a known limitation: parseRgb discards alpha.
+    // rgba(0,0,0,0) is parsed as black, so contrast with white equals 21.
+    expect(computeContrastRatio("rgba(0, 0, 0, 0)", "rgb(255, 255, 255)")).toBe(21);
+  });
+
+  it("accepts rgba() inputs for fg and bg", () => {
+    const ratio = computeContrastRatio("rgba(0, 0, 0, 1)", "rgba(255, 255, 255, 1)");
+    expect(ratio).toBe(21);
+  });
+});