Enum PacShExpMatch 

pub enum PacShExpMatch {
    Reference,
    Literal,
}

Available on crate features js and pac and std only.

How shExpMatch(str, shexp) reads its pattern.

Variants

Reference

What the reference implementations do: rewrite the expression into an anchored regex — escaping ., mapping * to .* and ? to . — which leaves every other regex metacharacter live.

This is the default because it is what a PAC file is written against: a pattern like vpn[0-9].corp.example keeps its reference character class semantics. It inherits the quirks that come with the transform — an unparenthesised | anchors only one of its branches, and a bracket expression that was meant literally (http://[2001:db8::1]/*) is a character class — so a deployment that would rather have neither can pick Self::Literal. Matching uses Rust’s bounded regex engine rather than ECMAScript RegExp; unsupported constructs and UTF-16 code-unit edge cases can therefore differ from a browser.

Literal

Treat every character but * and ? literally.

Diverges from browsers deliberately: a pattern means exactly what it spells, so no part of an operator’s rule can be satisfied by input a client chose. A rule relying on regex metacharacters stops matching instead, which is visible in testing rather than at an attacker’s choosing.

Trait Implementations

impl Clone for PacShExpMatch

fn clone(&self) -> PacShExpMatch

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for PacShExpMatch

impl Debug for PacShExpMatch

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for PacShExpMatch

fn default() -> PacShExpMatch

Returns the “default value” for a type.

impl Eq for PacShExpMatch

impl PartialEq for PacShExpMatch

fn eq(&self, other: &PacShExpMatch) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for PacShExpMatch