aboutsummaryrefslogtreecommitdiff
path: root/node_modules/sanitizer/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'node_modules/sanitizer/README.md')
-rw-r--r--node_modules/sanitizer/README.md44
1 files changed, 44 insertions, 0 deletions
diff --git a/node_modules/sanitizer/README.md b/node_modules/sanitizer/README.md
new file mode 100644
index 0000000..91bef44
--- /dev/null
+++ b/node_modules/sanitizer/README.md
@@ -0,0 +1,44 @@
+## Installation
+
+```
+npm install sanitizer
+```
+
+## Require
+
+```
+var sanitizer = require('sanitizer');
+```
+
+## Use
+
+See /test/test-sanitzer.js for full documentation.
+
+```
+sanitizer.escape('your dirty string'); // Escapes HTML special characters in attribute values as HTML entities
+```
+
+```
+var yourParser = sanitizer.makeSaxParser(yourHandler); // Given a SAX-like event handler, produce a function that feeds those events and a parameter to the event handler.
+```
+
+```
+sanitizer.normalizeRCData('your dirty string'); // Escape entities in RCDATA that can be escaped without changing the meaning.
+```
+
+```
+sanitizer.sanitize('your dirty string'); // Strips unsafe tags and attributes from html.
+```
+
+```
+exports.unescapeEntities('your string'); // The plain text of a chunk of HTML CDATA which possibly containing.
+```
+
+## Caveats
+
+It's use this at your own risk really - Caja HTML Sanitizer was written by people far cleverer than me. I have just repackaged it to solve a problem I had (sanitization on a Node server). It seems to work, and it passes all its tests in re-packaged form - however I don't fully understand its internals so cannot guarantee its security.
+
+
+## More information
+
+http://code.google.com/p/google-caja/source/browse/trunk/src/com/google/caja/plugin/html-sanitizer.js