snappymail/vendors/routes/hasher.js
2022-10-05 11:05:04 +02:00

95 lines
3.4 KiB
JavaScript

/*!!
* Hasher <http://github.com/millermedeiros/hasher>
* @author Miller Medeiros
* @version 1.1.2 (2012/10/31 03:19 PM)
* Released under the MIT License
*/
(global => {
//--------------------------------------------------------------------------------------
// Private
//--------------------------------------------------------------------------------------
const
_hashValRegexp = /#(.*)$/,
_hashRegexp = /^[#/]+/,
_hashTrim = /^\/+/g,
_trimHash = hash => hash?.replace(_hashTrim, '') || '',
_getWindowHash = () => {
//parsed full URL instead of getting window.location.hash because Firefox decode hash value (and all the other browsers don't)
var result = _hashValRegexp.exec( location.href );
return result?.[1] ? decodeURIComponent(result[1]) : '';
},
_registerChange = newHash => {
if (_hash !== newHash) {
var oldHash = _hash;
_hash = newHash; //should come before event dispatch to make sure user can get proper value inside event handler
_dispatch(_trimHash(newHash), _trimHash(oldHash));
}
},
_setHash = (path, replace) => {
path = path ? '/' + path.replace(_hashRegexp, '') : path;
if (path !== _hash){
// we should store raw value
_registerChange(path);
if (path === _hash) {
path = '#' + encodeURI(path)
// we check if path is still === _hash to avoid error in
// case of multiple consecutive redirects [issue #39]
replace
? location.replace(path)
: (location.hash = path);
}
}
},
_dispatch = (...args) => hasher.active && _bindings.forEach(callback => callback(...args)),
//--------------------------------------------------------------------------------------
// Public (API)
//--------------------------------------------------------------------------------------
hasher = /** @lends hasher */ {
clear : () => {
_bindings = [];
hasher.active = true;
},
/**
* Signal dispatched when hash value changes.
* - pass current hash as 1st parameter to listeners and previous hash value as 2nd parameter.
* @type signals.Signal
*/
active : true,
add : callback => _bindings.push(callback),
/**
* Start listening/dispatching changes in the hash/history.
* <ul>
* <li>hasher won't dispatch CHANGE events by manually typing a new value or pressing the back/forward buttons before calling this method.</li>
* </ul>
*/
init : () => _dispatch(_trimHash(_hash)),
/**
* Set Hash value, generating a new history record.
* @param {...string} path Hash value without '#'.
* @example hasher.setHash('lorem/ipsum/dolor') -> '#/lorem/ipsum/dolor'
*/
setHash : path => _setHash(path),
/**
* Set Hash value without keeping previous hash on the history record.
* @param {...string} path Hash value without '#'.
* @example hasher.replaceHash('lorem/ipsum/dolor') -> '#/lorem/ipsum/dolor'
*/
replaceHash : path => _setHash(path, true)
};
var _hash = _getWindowHash(),
_bindings = [];
addEventListener('hashchange', () => _registerChange(_getWindowHash()));
global.hasher = hasher;
})(this);