CodeQL library for JavaScript

Module TaintTracking

Provides classes for modelling taint propagation.

Import path

import javascript

Predicates

isTypeofGuard	Holds if `test` is a guard that checks if `operand` is typeof `tag`.
isUrlSearchParams	Holds if `params` is a construction of a `URLSearchParams` that parses the parameters in `input`.
localTaintStep	Holds if taint propagates from `pred` to `succ` in one local (intra-procedural) step.

Classes

AdHocWhitelistCheckSanitizer	A check of the form `if(<isWhitelisted>(x))`, which sanitizes `x` in its “then” branch.
AdditionalSanitizerGuardNode	A `SanitizerGuardNode` that controls which taint tracking configurations it is used in.
AdditionalTaintStep	A taint-propagating data flow edge that should be added to all taint tracking configurations in addition to standard data flow edges.
Configuration	A data flow tracking configuration that considers taint propagation through objects, arrays, promises and strings in addition to standard data flow.
ConstantComparison	A check of the form `if(x == 'some-constant')`, which sanitizes `x` in its “then” branch.
ErrorConstructorTaintStep	A taint step through an exception constructor, such as `x` to `new Error(x)`.
InSanitizer	A check of the form `if(x in o)`, which sanitizes `x` in its “then” branch.
IsEmptyGuard	A test of form `x.length === "0"`, preventing `x` from being tainted.
LabeledSanitizerGuardNode	A sanitizer guard node that only blocks specific flow labels.
MembershipTestSanitizer	A check of the form `whitelist.includes(x)` or equivalent, which sanitizes `x` in its “then” branch.
PersistentStorageTaintStep	A taint propagating data flow edge through persistent storage.
PositiveIndexOfSanitizer	A check of form `x.indexOf(y) > 0` or similar, which sanitizes `y` in the “then” branch.
SanitizerGuardNode	A node that can act as a sanitizer when appearing in a condition.
SanitizingRegExpTest	A conditional checking a tainted string against a regular expression, which is considered to be a sanitizer for all configurations.
StringConcatenationTaintStep	A taint propagating data flow edge arising from string concatenations.
TypeOfUndefinedSanitizer	A check of the form `type x === "undefined"`, which sanitized `x` in its “then” branch.
UndefinedCheckSanitizer	A check of the form `if(o[x] != undefined)`, which sanitizes `x` in its “then” branch.
WhitelistContainmentCallSanitizer	A check of the form `if(o.<contains>(x))`, which sanitizes `x` in its “then” branch.

Aliases

InclusionSanitizer	DEPRECATED. This class has been renamed to `MembershipTestSanitizer`.
StringInclusionSanitizer	DEPRECATED. This class has been renamed to `MembershipTestSanitizer`.
arrayFunctionTaintStep	A taint propagating data flow edge from `pred` to `succ` caused by a call `call` to a builtin array functions.