mini-utils
v0.0.21
Published
A mini script of utilities for Node and the Browser.
Downloads
8
Maintainers
facekapowReadme
mini-utils 
A mini script of utilities for Node and the Browser. This DOES extend the prototype of some things. 2.8kb minified and gzipped.
Install
Node:
npm install mini-utilsBower:
bower install mini-utilUsage
Node:
var __ = require('mini-utils'); // Double underscoreBower:
Add this to your HTML <head>:
<script src="/path/to/your/bower_components/mini-util/mini-utils.min.js"></script>If you want to use the script in a WebWorker, in the WebWorker you must:
importScripts('/path/to/your/bower_components/mini-util/mini-utils.min.js');Use the __ variable to access mini-utils. Example:
__.isNode(); // Again, double underscoreList of utilities:
Cross-environment Utils:
- isNode() - Boolean - Is the script running in Node?
- isBrowser() - Boolean - Is the script running in a browser?
- isWebWorker() - Boolean - Is the script running in a WebWorker?
- isElectron() - Boolean - Is the script running in Electron?
- inherits(Class, Class) - undefined - Minimal implementation of Node's
inherits. The first parameter is the class that inherits, and the second parameter is the superclass. - guid() - String - Generate a GUID (well, a pseudo-GUID).
- EventEmitter() - Class - Minimal implementation of Node's
EventEmitter. Full Node API is supported (including deprecated functions) (Node API link: https://nodejs.org/api/events.html). - nextTick(Function) - Unknown - A little nextTick shim (return depends on what method is used to achieve the shim).
- clone(Object) - Object - Creates a clone of an object and returns it.
Node-Only Utils (inlcudes Electron):
- homeDir() - String - Returns the user's home directory path.
WebWorker & Browser Utils (includes Electron):
- import(String, Function) - undefined - Requests a script from the url given in the first option, and executes the code and calls the function in the second option (which should accept an error parameter and a parameter containing the exports from the requested script).
- importSync(String) - Object - Synchronous version of
import. Returns the script's exports. WARNING: Uses synchronous version of XMLHttpRequest, which may hang the browser, strongly advised to use the async version above! - easyRequest(String[, Function]) - undefined/data - Performs a GET XMLHttpRequest with the url from the first parameter. If given a callback function, this performs the XMLHttpRequest asynchronously and passes the data to the callback (callback should accept first option as an error, second option as data). If not given a callback, this performs the XMLHttpRequest synchronously and returns the data. Advised to use the async version!
- easyPost(String[, data[, Function]]) - undefined/data - Exactly like the easyRequest function above, except performs a POST request and sends the data in the second parameter. Again, advised to use the async version!
WebWorker-Only Utils:
- PROTO-EXTENSION - self Extensions:
- emit(String/data[, ...data]) - Boolean - If the first parameter is not a string, it acts like
postMessage. Otherwise, it emits the event specified in the first parameter, and optionally passes the rest of the arguments as extra data. Returns true if the event has listeners, false otherwise. - on(String, Function) - this - Can act like
onmessagewhen given 'message' as the event. When the event specified in the first parameter is fired, the callback in the second parameter is called. - once(String, Function) - this - Can act like
onmessagewhen given 'message' as the event (except only fires once). When the event specified in the first parameter is fired, the callback in the second parameter is called. After the callback is done, it is removed from the listeners for that event. - removeListener(String, Function) - this - If found, and it matches the second parameter, the callback function for an the event specified in the first parameter is removed.
- removeAllListeners(String) - this - Removes all listeners for the event specified in the first parameter.
- emit(String/data[, ...data]) - Boolean - If the first parameter is not a string, it acts like
Browser-Only Utils (includes Electron):
- PROTO-EXTENSION - EventTarget Extensions:
- emit(String/data[, ...data]) - Boolean - If the first parameter is not a string, it acts like
postMessage. Otherwise, it emits the event specified in the first parameter, and optionally passes the rest of the arguments as extra data. Returns true if the event has listeners, false otherwise. - on(String, Function) - this - Can act like
onmessagewhen given 'message' as the event. When the event specified in the first parameter is fired, the callback in the second parameter is called. - once(String, Function) - this - Can act like
onmessagewhen given 'message' as the event (except only fires once). When the event specified in the first parameter is fired, the callback in the second parameter is called. After the callback is done, it is removed from the listeners for that event. - removeListener(String, Function) - this - If found, and it matches the second parameter, the callback function for an the event specified in the first parameter is removed.
- emit(String/data[, ...data]) - Boolean - If the first parameter is not a string, it acts like
- PROTO-EXTENSION - Worker Extensions:
- emit(String/data[, ...data]) - Boolean - If the first parameter is not a string, it acts like
postMessage. Otherwise, it emits the event specified in the first parameter, and optionally passes the rest of the arguments as extra data. Returns true if the event has listeners, false otherwise. - on(String, Function) - this - Can act like
onmessagewhen given 'message' as the event. When the event specified in the first parameter is fired, the callback in the second parameter is called. - once(String, Function) - this - Can act like
onmessagewhen given 'message' as the event (except only fires once). When the event specified in the first parameter is fired, the callback in the second parameter is called. After the callback is done, it is removed from the listeners for that event. - removeListener(String, Function) - this - If found, and it matches the second parameter, the callback function for an the event specified in the first parameter is removed.
- removeAllListeners(String) - this - Removes all listeners for the event specified in the first parameter.
- emit(String/data[, ...data]) - Boolean - If the first parameter is not a string, it acts like
- PROTO-EXTENSION - Document/HTMLDocument Extensions:
- on(String, Function) - this - When the event specified in the first parameter is fired, the callback in the second parameter is called.
- once(String, Function) - this - When the event specified in the first parameter is fired, the callback in the second parameter is called. After the callback is done, it is removed from the listeners for that event.
- ready(Function) - this - When the document is ready, the callback function is called.
- get(String) - HTMLElement - Get an element based on a query string (only accepts '#id', '.class', or 'tagName').
- create(String[, Object]) - HTMLElement - Create an element from a tag, and optionally initialize it with properties from the second argument.
- PROTO-EXTENSION - HTMLElement Extensions:
- on(String, Function) - this - When the event specified in the first parameter is fired, the callback in the second parameter is called.
- once(String, Function) - this - When the event specified in the first parameter is fired, the callback in the second parameter is called. After the callback is done, it is removed from the listeners for that event.
- remove() - this - Remove the current element.
- text([String]) - String/this - If given no parameters, returns the element's text. If given the first parameter, replaces the element's text with the new text.
- html([String]) - String/this - If given no parameters, returns the element's html. If given the first parameter, replaces the element's html with the new html.
- centerToWindow([Boolean]) - this - If given no parameters, it centers the element horizontally and vertically relative to the window. If the parameter is true, it only centers the element horizontally relative to the window. If the parameter is false, it only centers the element vertically relative to the window.
- prependChild(child) - this - Inserts the given child before the first node, essentially prepending the child.
- hasMultipleOfClass(String) - Boolean - Check if the element has multiple occurrences of a class.
- hasClass(String) - Boolean - Check if the element has a certain class.
- addClass(String) - this - Add the specified class to the element.
- removeClass(String) - this - Remove the specified class to the element.
- hide() - this - Hide the element.
- show() - this - Show the element.
- toggle() - this - Toggle the display state of the element.
- css(String/Object/Array[, String/Array]) - String/undefined, throws! - Easier with a table:
| First parameter | Second parameter | Return Value | |:-------------------------------:|:--------------------------------:|:--------------------------------:| | String - Property name | undefined | String - Property value | | String - Property name | String - Property Value | this | | Object - Object of properties | undefined | this | | Array - Array of property names | undefined | Array - Array of property values | | Array - Array of property names | Array - Array of property values | this |
Node-Only Utils:
None yet.