DOM-based XSS

About DOM-based XSS
DOM-based XSS (or type-0 XSS) is a type of  attack that occurs when client-side scripts (such as JavaScript) manipulate the page's DOM, allowing an attacker to run JavaScript in the victim's browser.

This class of XSS is distinct from Reflective XSS (type-1 XSS) and Stored XSS (type-2 XSS), since the server is not returning executable JavaScript to the browser.

Instead, data that has been sanitized by the server, or possibly never sent to the server, is converted to executable JavaScript by the existing code running on the page.

For example, consider this example script from the [https://www.owasp.org/index.php/DOM_Based_XSS OWASP website]:

... Select your language: document.write(""+document.location.href.substring(document.location.href.indexOf("default=")+8)+""); document.write("English"); ...

If the page is loaded with the 'default' parameter set to ' alert("xss") ' instead of the intended language string, then the extra script will be added into the page's DOM and executed as the page is loaded.

Preventing
Although JavaScript can be added to MediaWiki sites without a formal code review process, these scripts can put other users in danger if they don't prevent these attacks.

As with standard 1>Special:MyLanguage/Cross-site_scripting#Stopping_Cross-site_scripting|XSS prevention, you should validate the data coming in when possible, and always escape the data as your script writes out to the page.

In order to do this escaping, you should avoid using some methods that make escaping difficult, and instead use methods that make separation of HTML structure and values or text easy.

It can be tempting to use data attributes to provide information for javascript.

This is generally good practice, but remember that users are allowed to make elements with arbitrary data attributes too, so any information taken from a data attribute (e.g. using jQuery's ) should be treated as untrusted input and validated.

Avoid
In general, these functions should be avoided if possible.

They can be made secure, but require an understanding of how each browser's JavaScript engine works to make sure that all XSS vectors have been mitigated.

Element</>'s <tvar|2> </> and <tvar|3> </> methods

JQuery's <tvar|1> </> method (which uses <tvar|2>.innerHTML</>)

Using user data in jQuery's element creation

jQuery's <tvar|1>append</> method, when you are not certain of the type and value of every node or object you are appending.

If it is a string of (apparent) HTML, jQuery will implicitly convert it to an element.

<tvar|1> </> or <tvar|2> </>

Using user data in a string passed to <tvar|1> </>, <tvar|2> </>, an object's event handler, or <tvar|3> </> url targets

Using user data in strings that generate CSS

Use
When updating the page's DOM, you should typically use this pattern of functions for creating DOM elements and inserting them into the DOM:

As shown, you can use <tvar|1> </> to create the element, and any attributes that do not include user-controlled data.

You can also use <tvar|1></> to set the element's attributes.

When you have a correctly constructed element, you can use <tvar|1></> or <tvar|2></> to insert the element into the DOM.

But see 1>#Avoid</>|above; do not use <tvar|2>append</> or <tvar|3>appendTo</> if you do not know exactly what you are appending.

The <tvar|1></> method can be used to set the text body of an element, and will correctly escape any HTML.

If you're not using jQuery, you can use

Because the JavaScript is able to clearly interpret what strings are meant to represent element names, attribute names, and attribute values, it will correctly escape any HTML characters that may have been inserted into user-controlled data.

Sanitization
There may be times when you will need to mix user-controlled data with HTML.

In those cases, you will need to ensure that the user-controlled data is properly escaped for the HTML context where it is being inserted.

For example, inserting data into the text of a div element:

Requires different escaping than if you insert that user-controlled data into the id attribute of the div element.

A list of contexts and escaping rules can be found in the [<tvar|url>https://cheatsheetseries.owasp.org/cheatsheets/Cross_Site_Scripting_Prevention_Cheat_Sheet.html</> OWASP XSS Prevention Cheat Sheet]

For the most simple case (inserting user-controlled data into the text of an element), you can use jQuery's <tvar|1></> method or <tvar|2> </>.