aboutsummaryrefslogtreecommitdiffstats
path: root/packages/vold-utils/docs/unload+.md
diff options
context:
space:
mode:
Diffstat (limited to 'packages/vold-utils/docs/unload+.md')
-rw-r--r--packages/vold-utils/docs/unload+.md20
1 files changed, 20 insertions, 0 deletions
diff --git a/packages/vold-utils/docs/unload+.md b/packages/vold-utils/docs/unload+.md
new file mode 100644
index 0000000..78693ef
--- /dev/null
+++ b/packages/vold-utils/docs/unload+.md
@@ -0,0 +1,20 @@
+<!-- contributed by Erik Vold [erikvvold@gmail.com] -->
+
+The `unload+` module allows modules to register callbacks that are called
+when they are unloaded, and associate unload functions to containers to have the
+unloader automatically deleted when the container unloads.
+
+<api name="unload">
+@function
+ Save callbacks to run when unloading in a unload queue. Optionally scope the
+ callback to a container, e.g., window. Provide a way to run all the callbacks.
+
+@param callback {function}
+ A function to be called when the module unloads.
+@param [container] {object}
+ Optional container object; if the container "unloads" before the module
+ unloads, then the associated callback is removed from the unload queue.
+@returns {function}
+ Returns a function which will allow one to remove the callback from the unload
+ queue.
+</api>