Repository navigation
Upgrade notes:
- New reports carry
schemaVersion: "1.5.0". It adds the report languagehuand the
linked-pageobservation with its reasons. Consumers that accept 1.4.0 only must add 1.5.0
(schemas/report-1.5.0.schema.json). - On sites with subdomains, the first crawled page of up to five other hosts (
docs.,blog.)
now gets the consent, banner and HTTPS checks too. That can add findings and one consent run
per host.--host-checks mainor"hostChecks": "main"keeps the previous behaviour. - The legal notice and the privacy policy linked from the start page are loaded once more for the
newlegal-notice-content,privacy-policy-vendorsandprivacy-policy-contentrules, plus a
cookie policy the privacy policy links. That is up to three extra page loads per scan, also
through a network adapter, and can add findings. Deselect a rule to skip its load. Without a
legal notice link, a page behind a vague legal link or the privacy policy is read instead. - New dependency
pdfjs-dist(5.1.x, the last line that supports Node 20.12) to read PDF cookie
policies. It brings the optional@napi-rs/canvas, which privalint does not use; install with
--omit=optionalto skip it. - Native scans make DNS lookups for up to 20 first-party subdomains that received requests, to
find CNAME-cloaked trackers. Scans through a network adapter make none. - New rules run by default and can add findings:
mixed-contentreports a form that submits over
HTTP as an error, so scans with the default--fail-on errorcan fail on it;
form-preticked-consent,privacy-policy-content,third-party-personal-dataand
banner-keyboardadd warnings,
referrer-policyinfo. - Values of e-mail and phone parameters in request addresses are replaced by
[redacted]in
finding evidence, so evidence strings of native scans can differ from earlier reports. - Scans with the settings check can report the new
consent-preselectederror on banners whose
settings layer starts with optional categories switched on.
Added
- Fix guides for Cookiebot, Usercentrics, OneTrust and Complianz (
docs/fixes, English and
German): each consent finding mapped to the setting in that consent manager, every step linked to
the vendor's documentation. When the consent manager is recognised, the fix of the finding links
the section; Hungarian reports link the English guide. Complianz's documented reopen class
cmplz-show-bannernow counts as a settings link (#138) privacy-policy-vendorsreads a cookie policy published as a PDF on the same site: it is
downloaded (up to 5 MB, through the network adapter when there is one) and its text extracted
with pdf.js, without running code from the file. A PDF that fails or is larger stays unread as
before (#113)--format html(and-o report.html) writes a self-contained HTML report with inline CSS for
light and dark: findings by page and severity, evidence in collapsible sections, fixes, legal
basis and the disclaimer. Every scanned value is escaped, and the page loads nothing (#129)--baseline <report.json>(Action inputbaseline) compares the findings with an earlier JSON
report: each finding is markedneworexistingby rule, page and subject (the SARIF
fingerprint),baseline.fixedlists the findings that are gone where the rule ran again, and--fail-oncounts new
findings only. Text and Markdown show the counts, SARIF setsbaselineState. A baseline with
another schema major version is rejected (#128)- New opt-in rule
gpc-signal(--gpc, configgpc, Action inputgpc): privalint loads the
start page once more with Global Privacy Control (Sec-GPC: 1and
navigator.globalPrivacyControl) and notes as info whether the banner hides and trackers stay
away. The outcome is inconsent.gpc(schema 1.5.0) (#132) --check-accept(configacceptCheck, Action inputcheck-accept): privalint also accepts in a
fresh browser, reloads and records what loads then.privacy-policy-vendorsthen also looks for
services that run only with consent, andthirdPartieslists them with the phase
after-accept. The outcome is inconsent.accept(schema 1.5.0); there is no finding of its
own (#131)- New rule
banner-keyboard(warning): before clicking reject, privalint presses Tab up to 60
times and warns when the reject control never gets focus, with the element and the press that
focused the accept control as evidence (#122) - CNAME-cloaked trackers: native scans resolve the CNAME chain of first-party subdomains that
received requests and report a chain that reaches a tracker (from the tracker list and AdGuard's
cname-trackers list) throughpre-consent-trackers, with the chain as evidence. No DNS lookups
through a network adapter or offline (#126) - New rule
fingerprinting(warning): a third-party script reads back a canvas, the unmasked WebGL
renderer or an offline audio rendering before consent. Charts that only draw are not reported;
reCAPTCHA, hCaptcha and Turnstile are info. The Fingerprint agent hosts are on the tracker list
(#124) - Trackers routed through the site's own domain are recognised by their path and parameters on
any host: GA4/g/collect?v=2&tid=G-…, Universal Analytics collect hits, server-side Google Tag
Managergtm.js?id=GTM-…andgtag/js?id=G-…, and Meta Pixel/tr?id=…&ev=…. The evidence names
the host they were proxied through (#125) - New opt-in rule
trackers-after-close(--check-close, configcloseCheck, Action input
check-close): privalint closes the banner with its close button ("×", "Schließen") in a fresh
browser, reloads and reports trackers that load then as errors, since closing is no choice. A
banner without a close button counts as checked. The result is inconsent.close(schema
1.5.0) (#121) - New rule
banner-language(info): the consent banner is in another language than the page's
<html lang>, guessed from common words of eight languages. A banner in the language of the
browser locale is not reported, since many consent managers follow it (#123) --sitemap(configsitemap, Action inputsitemap) chooses the pages after the start page from
the sitemap:Sitemap:lines in robots.txt, else/sitemap.xml, with sitemap indexes one level
deep. Up to half the pages go to pages likely to hold forms or checkout steps (/kontakt,
/newsletter,/checkout, …), shallowest first and one per section; the rest take one page per
section in turn. Same-site pages only, withinmaxPages; without
a sitemap the crawl follows links as before (#133)- Reports list every host outside the site that answered a request in
thirdParties: registrable
domain, first page, phases, request count and the vendor privalint knows it as, hosts only. The
Markdown report shows it as a collapsed table, a starting point for the privacy policy and for
new list entries (#127) --device <name>(configdevice, Action inputdevice) emulates a Playwright device such as
"iPhone 15": viewport, user agent and touch, so banners are checked in their mobile layout, where
the reject button is often hidden or smaller. The report records it inoptions.device
(schema 1.5.0) (#130)- New rule
third-party-personal-data(warning): requests to other sites carry e-mail
addresses or phone numbers in their query string, plain or as SHA-256 hashes in parameters
such asemorud[em]. Only parameter names are reported, and the values are replaced by
[redacted]in every finding that shows a request address (#118) third-party-embedsfixes point to the YouTube privacy-enhanced mode, the Vimeodnt=1
parameter and a placeholder image for Google Maps. None replaces consent (#137)- New rule
form-preticked-consent(warning): a form ticks a newsletter or advertising consent
checkbox before the visitor chooses (#139) - New rule
mixed-content: a form on an HTTPS page submits to anhttp://address (error);
scripts, images, frames or stylesheets referenced over HTTP are info (#120) - New rule
referrer-policy(info): the page setsunsafe-urlorno-referrer-when-downgradeby
header or meta tag and contacts other hosts, which then receive the full page address (#119) - New rule
privacy-policy-content: the privacy policy gives no e-mail or postal address of the
controller, or still contains template text such as[Firmenname]or "Musterstraße" (warning);
a data protection officer named without contact details is info. On an overview page that links
further privacy documents, a missing contact is info (#116) legal-notice-contentreads a page behind a vague legal link ("Rechtliche Hinweise") or the
privacy policy when the start page links no legal notice, and reports what it misses there as
info (#114)- Trackers from the vendors' own documentation: Google Ads conversions on
www.google.com,
Reddit Pixel, VWO (hosts and cookies), Microsoft Xandr universal pixel and the Amazon Associates
oneTag (#71) - The Drupal banner EU Cookie Compliance is recognised by name, as seen on a Hungarian railway
site that offers only "accept all" --lang hu: findings, fixes and the text, Markdown and SARIF reports in Hungarian, with
schema 1.5.0 for the new language value (#59)- New rule
privacy-policy-vendors: trackers and cookie-setting embeds the start page uses that
the privacy policy, or a cookie policy it links, doesn't name (warning); font services, CDNs and
other listed services as info. Names match as whole words, with known other names (#105) - New rule
legal-notice-content: the legal notice linked from the start page gives no postal
address or e-mail address (warning), or names a registered legal form without a register entry
(info). Postcodes of Germany, Austria, Switzerland and Hungary are recognised (#104). With
--region hua missing tax number of a company, with--region ata missing media disclosure
(Offenlegung) is noted as info (#115) - New rule
third-country-providers(info): error monitoring, performance monitoring, feature
flag and backend services outside the EU/EEA contacted before consent, such as Sentry on
ingest.us.sentry.ioor a Supabase project. Region hosts in the EU are not reported (#109) - New rule
reject-less-prominent(info): a first-layer reject control shown as plain text next
to an accept button, with less than half its area, or with low text contrast, measured from the
rendered box and computed styles (#107) - New rule
consent-preselected(error, with the settings check): optional categories, or a wider
consent level, already switched on when the banner settings open, named by their labels in
consent.settings.preselected(#106) - New rule
tracking-cookie-lifetime(info): tracking cookies that last longer than 13 months,
the CNIL's recommended maximum, with their lifetime in days (#108) - Start-page checks on other hosts of the site: consent, reject, banner and HTTPS rules run on the
first crawled page of each subdomain, up to five. Their consent results are inconsentByHost.
--host-checks mainturns it off (#103) - Every report has
ruleSummary: per rule, pages with a finding, checked without one, not
evaluable and skipped by reason, plus the page IDs worth a look.--evaluations summarywrites
JSON without the per-page rule evaluations; the coverage gate reads the summary then and gives
the same verdict (#101) - Adapter scans record how long the adapter took:
capture.diagnostics.timing.adapterhas the
number of requests, the median and 95th percentile time to the response headers, and the five
slowest requests split into queue, headers and body time. Text and Markdown reports print it on
pages with timeouts, so a slow adapter environment stands out (#99)
Changed
- Text and Markdown reports show an
impressum-linkorprivacy-policy-linkfinding that repeats
on several pages once, under "On several pages", with the pages listed. JSON and SARIF still
have one finding per page. The messages no longer say "on this page" (#102)
Fixed
legal-notice-contentonly accepts an address when the street sits on the postcode's line or
the line above it, so a stray number and a year in other paragraphs no longer pass (#142)legal-notice-contentandprivacy-policy-vendorsno longer say "checked, no finding" when
they had nothing to read: on other pages they are skipped (not-start-page), without a link
they are skipped (no-linked-page), and when the page didn't load they are not evaluable
(linked-page-not-loaded). A finding about something missing from a page that didn't load
completely is not evaluable either (#141). A start page without such a link does not count as incomplete for
--fail-on-incomplete;impressum-linkandprivacy-policy-linkreport the missing link- A request that never finishes no longer makes every document rule not evaluable. When the page
itself was read, a rule that finds what it looks for (the Impressum link, the privacy link)
counts as checked; a finding about something missing stays not evaluable, since the missing
part may not have loaded (#140) - Side loads of the legal notice and the privacy policy skip error pages (404, 500) and links that
lead nowhere, such as a "Privacy settings" button withhref="#"before the policy link consent-preselectedonly counts switches the visitor can actually switch off, and keeps what
it saw when a later step of the settings check failslegal-notice-contentrecognises UK postcodes and Irish Eircodes, ignores floors written as
"OG"/"UG", legal forms of the host or web designer, copyright years, phone numbers and
"at office." when looking for address, e-mail and legal formprivacy-policy-vendorsmatches vendors named with a slash ("DoubleClick/Google Marketing")
and "X" as Twitterreject-less-prominentmeasures translucent buttons on dark banners andoklch()colourstracking-cookie-lifetimemeasures 13 calendar months, so a cookie set for exactly 13 months
is never reported- Hungarian report text uses the right article before abbreviations and numbers ("az SE", "az 5")
- Grouped findings in text and Markdown reports keep different vendors with the same fix apart
privacy-policy-vendorsdrops to info when the privacy policy links a cookie policy it can't
read, such as a PDF, and names that link- Text and Markdown reports also show a
third-country-providersorthird-party-cdnsfinding
that repeats on several pages once per vendor consent-preselectedis evaluated whenever the settings layer opened, also when no save button
was found; before, it was not evaluable there- A video, image or font over
maxResponseBytesno longer makes an adapter scan page partial. It
is delivered without its body, with status and headers kept, and noted asresource-limitwith
skippedReason: 'policy'(#100)