mirror of
https://github.com/gorhill/uBlock.git
synced 2024-09-30 06:37:10 +02:00
680 lines
21 KiB
JavaScript
680 lines
21 KiB
JavaScript
/*******************************************************************************
|
|
|
|
uBlock Origin - a browser extension to block requests.
|
|
Copyright (C) 2014-2017 Raymond Hill
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program. If not, see {http://www.gnu.org/licenses/}.
|
|
|
|
Home: https://github.com/gorhill/uBlock
|
|
*/
|
|
|
|
'use strict';
|
|
|
|
/******************************************************************************/
|
|
|
|
// Start isolation from global scope
|
|
|
|
µBlock.webRequest = (function() {
|
|
|
|
/******************************************************************************/
|
|
|
|
var exports = {};
|
|
|
|
/******************************************************************************/
|
|
|
|
// https://github.com/gorhill/uBlock/issues/2067
|
|
// Experimental: Block everything until uBO is fully ready.
|
|
// TODO: re-work vAPI code to match more closely how listeners are
|
|
// registered with the webRequest API. This will simplify implementing
|
|
// the feature here: we could have a temporary onBeforeRequest listener
|
|
// which blocks everything until all is ready.
|
|
// This would allow to avoid the permanent special test at the top of
|
|
// the main onBeforeRequest just to implement this.
|
|
var onBeforeReady = null;
|
|
|
|
if ( µBlock.hiddenSettings.suspendTabsUntilReady ) {
|
|
onBeforeReady = (function() {
|
|
var suspendedTabs = new Set();
|
|
µBlock.onStartCompletedQueue.push(function(callback) {
|
|
onBeforeReady = null;
|
|
var iter = suspendedTabs.values(),
|
|
entry;
|
|
for (;;) {
|
|
entry = iter.next();
|
|
if ( entry.done ) { break; }
|
|
vAPI.tabs.reload(entry.value);
|
|
}
|
|
callback();
|
|
});
|
|
return function(tabId) {
|
|
if ( vAPI.isBehindTheSceneTabId(tabId) ) { return; }
|
|
suspendedTabs.add(tabId);
|
|
return true;
|
|
};
|
|
})();
|
|
} else {
|
|
µBlock.onStartCompletedQueue.push(function(callback) {
|
|
vAPI.onLoadAllCompleted();
|
|
callback();
|
|
});
|
|
}
|
|
|
|
/******************************************************************************/
|
|
|
|
// Intercept and filter web requests.
|
|
|
|
var onBeforeRequest = function(details) {
|
|
var tabId = details.tabId;
|
|
if ( onBeforeReady !== null && onBeforeReady(tabId) ) {
|
|
return { cancel: true };
|
|
}
|
|
|
|
// Special handling for root document.
|
|
// https://github.com/chrisaljoudi/uBlock/issues/1001
|
|
// This must be executed regardless of whether the request is
|
|
// behind-the-scene
|
|
var requestType = details.type;
|
|
if ( requestType === 'main_frame' ) {
|
|
return onBeforeRootFrameRequest(details);
|
|
}
|
|
|
|
// Special treatment: behind-the-scene requests
|
|
if ( vAPI.isBehindTheSceneTabId(tabId) ) {
|
|
return onBeforeBehindTheSceneRequest(details);
|
|
}
|
|
|
|
// Lookup the page store associated with this tab id.
|
|
var µb = µBlock,
|
|
pageStore = µb.pageStoreFromTabId(tabId);
|
|
if ( !pageStore ) {
|
|
var tabContext = µb.tabContextManager.mustLookup(tabId);
|
|
if ( vAPI.isBehindTheSceneTabId(tabContext.tabId) ) {
|
|
return onBeforeBehindTheSceneRequest(details);
|
|
}
|
|
vAPI.tabs.onNavigation({ tabId: tabId, frameId: 0, url: tabContext.rawURL });
|
|
pageStore = µb.pageStoreFromTabId(tabId);
|
|
}
|
|
|
|
// https://github.com/chrisaljoudi/uBlock/issues/886
|
|
// For requests of type `sub_frame`, the parent frame id must be used
|
|
// to lookup the proper context:
|
|
// > If the document of a (sub-)frame is loaded (type is main_frame or
|
|
// > sub_frame), frameId indicates the ID of this frame, not the ID of
|
|
// > the outer frame.
|
|
// > (ref: https://developer.chrome.com/extensions/webRequest)
|
|
var isFrame = requestType === 'sub_frame';
|
|
|
|
// https://github.com/chrisaljoudi/uBlock/issues/114
|
|
var requestContext = pageStore.createContextFromFrameId(isFrame ? details.parentFrameId : details.frameId);
|
|
|
|
// Setup context and evaluate
|
|
var requestURL = details.url;
|
|
requestContext.requestURL = requestURL;
|
|
requestContext.requestHostname = µb.URI.hostnameFromURI(requestURL);
|
|
requestContext.requestType = requestType;
|
|
|
|
var result = pageStore.filterRequest(requestContext);
|
|
|
|
pageStore.journalAddRequest(requestContext.requestHostname, result);
|
|
|
|
if ( µb.logger.isEnabled() ) {
|
|
µb.logger.writeOne(
|
|
tabId,
|
|
'net',
|
|
result,
|
|
requestType,
|
|
requestURL,
|
|
requestContext.rootHostname,
|
|
requestContext.pageHostname
|
|
);
|
|
}
|
|
|
|
// Not blocked
|
|
if ( µb.isAllowResult(result) ) {
|
|
// https://github.com/chrisaljoudi/uBlock/issues/114
|
|
if ( details.parentFrameId !== -1 && isFrame ) {
|
|
pageStore.setFrame(details.frameId, requestURL);
|
|
}
|
|
requestContext.dispose();
|
|
return;
|
|
}
|
|
|
|
// Blocked
|
|
|
|
// https://github.com/gorhill/uBlock/issues/949
|
|
// Redirect blocked request?
|
|
if ( µb.hiddenSettings.ignoreRedirectFilters !== true ) {
|
|
var url = µb.redirectEngine.toURL(requestContext);
|
|
if ( url !== undefined ) {
|
|
pageStore.internalRedirectionCount += 1;
|
|
if ( µb.logger.isEnabled() ) {
|
|
µb.logger.writeOne(
|
|
tabId,
|
|
'redirect',
|
|
'rr:' + µb.redirectEngine.resourceNameRegister,
|
|
requestType,
|
|
requestURL,
|
|
requestContext.rootHostname,
|
|
requestContext.pageHostname
|
|
);
|
|
}
|
|
requestContext.dispose();
|
|
return { redirectUrl: url };
|
|
}
|
|
}
|
|
|
|
requestContext.dispose();
|
|
return { cancel: true };
|
|
};
|
|
|
|
/******************************************************************************/
|
|
|
|
var onBeforeRootFrameRequest = function(details) {
|
|
var tabId = details.tabId,
|
|
requestURL = details.url,
|
|
µb = µBlock;
|
|
|
|
µb.tabContextManager.push(tabId, requestURL);
|
|
|
|
// Special handling for root document.
|
|
// https://github.com/chrisaljoudi/uBlock/issues/1001
|
|
// This must be executed regardless of whether the request is
|
|
// behind-the-scene
|
|
var µburi = µb.URI,
|
|
requestHostname = µburi.hostnameFromURI(requestURL),
|
|
requestDomain = µburi.domainFromHostname(requestHostname) || requestHostname,
|
|
result = '';
|
|
var context = {
|
|
rootHostname: requestHostname,
|
|
rootDomain: requestDomain,
|
|
pageHostname: requestHostname,
|
|
pageDomain: requestDomain,
|
|
requestURL: requestURL,
|
|
requestHostname: requestHostname,
|
|
requestType: 'main_frame'
|
|
};
|
|
|
|
// If the site is whitelisted, disregard strict blocking
|
|
if ( µb.getNetFilteringSwitch(requestURL) === false ) {
|
|
result = 'ua:whitelisted';
|
|
}
|
|
|
|
// Permanently unrestricted?
|
|
if ( result === '' && µb.hnSwitches.evaluateZ('no-strict-blocking', requestHostname) ) {
|
|
result = 'ua:no-strict-blocking: ' + µb.hnSwitches.z + ' true';
|
|
}
|
|
|
|
// Temporarily whitelisted?
|
|
if ( result === '' ) {
|
|
result = isTemporarilyWhitelisted(result, requestHostname);
|
|
if ( result.charAt(1) === 'a' ) {
|
|
result = 'ua:no-strict-blocking true (temporary)';
|
|
}
|
|
}
|
|
|
|
// Static filtering: We always need the long-form result here.
|
|
var snfe = µb.staticNetFilteringEngine;
|
|
|
|
// Check for specific block
|
|
if (
|
|
result === '' &&
|
|
snfe.matchStringExactType(context, requestURL, 'main_frame') !== undefined
|
|
) {
|
|
result = snfe.toResultString(true);
|
|
}
|
|
|
|
// Check for generic block
|
|
if (
|
|
result === '' &&
|
|
snfe.matchStringExactType(context, requestURL, 'no_type') !== undefined
|
|
) {
|
|
result = snfe.toResultString(true);
|
|
// https://github.com/chrisaljoudi/uBlock/issues/1128
|
|
// Do not block if the match begins after the hostname, except when
|
|
// the filter is specifically of type `other`.
|
|
// https://github.com/gorhill/uBlock/issues/490
|
|
// Removing this for the time being, will need a new, dedicated type.
|
|
if ( result.charAt(1) === 'b' ) {
|
|
result = toBlockDocResult(requestURL, requestHostname, result);
|
|
}
|
|
}
|
|
|
|
// Log
|
|
var pageStore = µb.bindTabToPageStats(tabId, 'beforeRequest');
|
|
if ( pageStore ) {
|
|
pageStore.journalAddRootFrame('uncommitted', requestURL);
|
|
pageStore.journalAddRequest(requestHostname, result);
|
|
}
|
|
|
|
if ( µb.logger.isEnabled() ) {
|
|
µb.logger.writeOne(
|
|
tabId,
|
|
'net',
|
|
result,
|
|
'main_frame',
|
|
requestURL,
|
|
requestHostname,
|
|
requestHostname
|
|
);
|
|
}
|
|
|
|
// Not blocked
|
|
if ( µb.isAllowResult(result) ) {
|
|
return;
|
|
}
|
|
|
|
var compiled = result.slice(3);
|
|
|
|
// Blocked
|
|
var query = btoa(JSON.stringify({
|
|
url: requestURL,
|
|
hn: requestHostname,
|
|
dn: requestDomain,
|
|
fc: compiled,
|
|
fs: snfe.filterStringFromCompiled(compiled)
|
|
}));
|
|
|
|
vAPI.tabs.replace(tabId, vAPI.getURL('document-blocked.html?details=') + query);
|
|
|
|
return { cancel: true };
|
|
};
|
|
|
|
/******************************************************************************/
|
|
|
|
var toBlockDocResult = function(url, hostname, result) {
|
|
// Make a regex out of the result
|
|
var re = µBlock.staticNetFilteringEngine
|
|
.filterRegexFromCompiled(result.slice(3), 'gi');
|
|
if ( re === null ) {
|
|
return '';
|
|
}
|
|
var matches = re.exec(url);
|
|
if ( matches === null ) {
|
|
return '';
|
|
}
|
|
|
|
// https://github.com/chrisaljoudi/uBlock/issues/1128
|
|
// https://github.com/chrisaljoudi/uBlock/issues/1212
|
|
// Relax the rule: verify that the match is completely before the path part
|
|
if ( re.lastIndex <= url.indexOf(hostname) + hostname.length + 1 ) {
|
|
return result;
|
|
}
|
|
|
|
return '';
|
|
};
|
|
|
|
/******************************************************************************/
|
|
|
|
// Intercept and filter behind-the-scene requests.
|
|
|
|
// https://github.com/gorhill/uBlock/issues/870
|
|
// Finally, Chromium 49+ gained the ability to report network request of type
|
|
// `beacon`, so now we can block them according to the state of the
|
|
// "Disable hyperlink auditing/beacon" setting.
|
|
|
|
var onBeforeBehindTheSceneRequest = function(details) {
|
|
var µb = µBlock,
|
|
pageStore = µb.pageStoreFromTabId(vAPI.noTabId);
|
|
if ( !pageStore ) { return; }
|
|
|
|
var result = '',
|
|
context = pageStore.createContextFromPage(),
|
|
requestType = details.type,
|
|
requestURL = details.url;
|
|
|
|
context.requestURL = requestURL;
|
|
context.requestHostname = µb.URI.hostnameFromURI(requestURL);
|
|
context.requestType = requestType;
|
|
|
|
// https://bugs.chromium.org/p/chromium/issues/detail?id=637577#c15
|
|
// Do not filter behind-the-scene network request of type `beacon`: there
|
|
// is no point. In any case, this will become a non-issue once
|
|
// <https://bugs.chromium.org/p/chromium/issues/detail?id=522129> is
|
|
// fixed.
|
|
|
|
// Blocking behind-the-scene requests can break a lot of stuff: prevent
|
|
// browser updates, prevent extension updates, prevent extensions from
|
|
// working properly, etc.
|
|
// So we filter if and only if the "advanced user" mode is selected
|
|
if ( µb.userSettings.advancedUserEnabled ) {
|
|
result = pageStore.filterRequestNoCache(context);
|
|
}
|
|
|
|
pageStore.journalAddRequest(context.requestHostname, result);
|
|
|
|
if ( µb.logger.isEnabled() ) {
|
|
µb.logger.writeOne(
|
|
vAPI.noTabId,
|
|
'net',
|
|
result,
|
|
requestType,
|
|
requestURL,
|
|
context.rootHostname,
|
|
context.rootHostname
|
|
);
|
|
}
|
|
|
|
context.dispose();
|
|
|
|
// Not blocked
|
|
if ( µb.isAllowResult(result) ) {
|
|
return;
|
|
}
|
|
|
|
// Blocked
|
|
return { 'cancel': true };
|
|
};
|
|
|
|
/******************************************************************************/
|
|
|
|
// To handle:
|
|
// - inline script tags
|
|
// - websockets
|
|
// - media elements larger than n kB
|
|
|
|
var onHeadersReceived = function(details) {
|
|
// Do not interfere with behind-the-scene requests.
|
|
var tabId = details.tabId;
|
|
if ( vAPI.isBehindTheSceneTabId(tabId) ) { return; }
|
|
|
|
var µb = µBlock,
|
|
requestType = details.type;
|
|
|
|
if ( requestType === 'main_frame' ) {
|
|
µb.tabContextManager.push(tabId, details.url);
|
|
}
|
|
|
|
var pageStore = µb.pageStoreFromTabId(tabId);
|
|
if ( pageStore === null ) {
|
|
if ( requestType !== 'main_frame' ) { return; }
|
|
pageStore = µb.bindTabToPageStats(tabId, 'beforeRequest');
|
|
}
|
|
if ( pageStore.getNetFilteringSwitch() === false ) { return; }
|
|
|
|
if ( requestType === 'image' || requestType === 'media' ) {
|
|
return foilLargeMediaElement(pageStore, details);
|
|
}
|
|
|
|
// https://github.com/gorhill/uBO-Extra/issues/19
|
|
// Turns out scripts must also be considered as potential embedded
|
|
// contexts (as workers) and as such we may need to inject content
|
|
// security policy directives.
|
|
if ( requestType === 'script' || requestType === 'main_frame' || requestType === 'sub_frame' ) {
|
|
return processCSP(pageStore, details);
|
|
}
|
|
};
|
|
|
|
/******************************************************************************/
|
|
|
|
var processCSP = function(pageStore, details) {
|
|
var µb = µBlock,
|
|
tabId = details.tabId,
|
|
requestURL = details.url,
|
|
loggerEnabled = µb.logger.isEnabled();
|
|
|
|
var context = pageStore.createContextFromPage();
|
|
context.requestHostname = µb.URI.hostnameFromURI(requestURL);
|
|
if ( details.type !== 'main_frame' ) {
|
|
context.pageHostname = context.pageDomain = context.requestHostname;
|
|
}
|
|
|
|
var inlineScriptResult, blockInlineScript,
|
|
workerResult, blockWorker;
|
|
if ( details.type !== 'script' ) {
|
|
context.requestType = 'inline-script';
|
|
context.requestURL = requestURL;
|
|
inlineScriptResult = pageStore.filterRequestNoCache(context);
|
|
blockInlineScript = µb.isBlockResult(inlineScriptResult);
|
|
// https://github.com/gorhill/uBlock/issues/2360
|
|
// https://github.com/gorhill/uBlock/issues/2440
|
|
context.requestType = 'script';
|
|
context.requestURL = 'blob:';
|
|
µb.staticNetFilteringEngine.matchString(context);
|
|
workerResult = µb.staticNetFilteringEngine.toResultString(loggerEnabled);
|
|
blockWorker = µb.isBlockResult(workerResult);
|
|
}
|
|
|
|
µb.staticNetFilteringEngine.matchStringExactType(context, requestURL, 'websocket');
|
|
var websocketResult = µb.staticNetFilteringEngine.toResultString(loggerEnabled),
|
|
blockWebsocket = µb.isBlockResult(websocketResult);
|
|
|
|
var headersChanged;
|
|
if ( blockInlineScript || blockWebsocket || blockWorker ) {
|
|
headersChanged = foilWithCSP(
|
|
details.responseHeaders,
|
|
blockInlineScript,
|
|
blockWebsocket,
|
|
blockWorker
|
|
);
|
|
}
|
|
|
|
if ( loggerEnabled && details.type !== 'script' ) {
|
|
if ( blockInlineScript !== undefined ) {
|
|
µb.logger.writeOne(
|
|
tabId,
|
|
'net',
|
|
inlineScriptResult,
|
|
'inline-script',
|
|
requestURL,
|
|
context.rootHostname,
|
|
context.pageHostname
|
|
);
|
|
}
|
|
if ( websocketResult ) {
|
|
µb.logger.writeOne(
|
|
tabId,
|
|
'net',
|
|
websocketResult,
|
|
'websocket',
|
|
requestURL,
|
|
context.rootHostname,
|
|
context.pageHostname
|
|
);
|
|
}
|
|
if ( workerResult ) {
|
|
µb.logger.writeOne(
|
|
tabId,
|
|
'net',
|
|
workerResult,
|
|
'worker',
|
|
requestURL,
|
|
context.rootHostname,
|
|
context.pageHostname
|
|
);
|
|
}
|
|
}
|
|
|
|
context.dispose();
|
|
|
|
if ( headersChanged !== true ) { return; }
|
|
|
|
µb.updateBadgeAsync(tabId);
|
|
|
|
return { 'responseHeaders': details.responseHeaders };
|
|
};
|
|
|
|
/******************************************************************************/
|
|
|
|
// https://github.com/gorhill/uBlock/issues/1163
|
|
// "Block elements by size"
|
|
|
|
var foilLargeMediaElement = function(pageStore, details) {
|
|
var µb = µBlock;
|
|
|
|
var i = headerIndexFromName('content-length', details.responseHeaders);
|
|
if ( i === -1 ) { return; }
|
|
|
|
var tabId = details.tabId,
|
|
size = parseInt(details.responseHeaders[i].value, 10) || 0,
|
|
result = pageStore.filterLargeMediaElement(size);
|
|
if ( result === undefined ) { return; }
|
|
|
|
if ( µb.logger.isEnabled() ) {
|
|
µb.logger.writeOne(
|
|
tabId,
|
|
'net',
|
|
result,
|
|
details.type,
|
|
details.url,
|
|
pageStore.tabHostname,
|
|
pageStore.tabHostname
|
|
);
|
|
}
|
|
|
|
return { cancel: true };
|
|
};
|
|
|
|
/******************************************************************************/
|
|
|
|
var foilWithCSP = function(headers, noInlineScript, noWebsocket, noBlobWorker) {
|
|
var i = headerIndexFromName('content-security-policy', headers),
|
|
cspSubset = [];
|
|
|
|
if ( noInlineScript ) {
|
|
cspSubset.push("script-src 'unsafe-eval' *");
|
|
}
|
|
|
|
if ( noWebsocket ) {
|
|
cspSubset.push('connect-src http: https:');
|
|
}
|
|
|
|
// https://www.w3.org/TR/CSP2/#directive-child-src
|
|
// https://www.w3.org/TR/CSP3/#directive-worker-src
|
|
if ( noBlobWorker ) {
|
|
cspSubset.push('child-src http: https:');
|
|
}
|
|
|
|
// https://bugs.chromium.org/p/chromium/issues/detail?id=513860
|
|
// Bad Chromium bug: web pages can work around CSP directives by
|
|
// creating data:- or blob:-based URI. So if we must restrict using CSP,
|
|
// we have no choice but to also prevent the creation of nested browsing
|
|
// contexts based on data:- or blob:-based URIs.
|
|
if ( vAPI.chrome && (noInlineScript || noWebsocket) ) {
|
|
// https://w3c.github.io/webappsec-csp/#directive-frame-src
|
|
cspSubset.push('frame-src http: https:');
|
|
}
|
|
|
|
if ( cspSubset.length === 0 ) { return; }
|
|
|
|
var csp;
|
|
if ( i !== -1 ) {
|
|
csp = headers[i].value.trim();
|
|
headers.splice(i, 1);
|
|
}
|
|
|
|
// Use comma to add a new subset to potentially existing one(s). This new
|
|
// subset has its own reporting options and won't cause spurious CSP
|
|
// reports to outside world.
|
|
// Ref.: https://www.w3.org/TR/CSP2/#implementation-considerations
|
|
cspSubset = cspSubset.join('; ');
|
|
headers.push({
|
|
name: 'Content-Security-Policy',
|
|
value: csp === undefined ? cspSubset : csp + ', ' + cspSubset
|
|
});
|
|
|
|
return true;
|
|
};
|
|
|
|
/******************************************************************************/
|
|
|
|
// Caller must ensure headerName is normalized to lower case.
|
|
|
|
var headerIndexFromName = function(headerName, headers) {
|
|
var i = headers.length;
|
|
while ( i-- ) {
|
|
if ( headers[i].name.toLowerCase() === headerName ) {
|
|
return i;
|
|
}
|
|
}
|
|
return -1;
|
|
};
|
|
|
|
/******************************************************************************/
|
|
|
|
vAPI.net.onBeforeRequest = {
|
|
urls: [
|
|
'http://*/*',
|
|
'https://*/*'
|
|
],
|
|
extra: [ 'blocking' ],
|
|
callback: onBeforeRequest
|
|
};
|
|
|
|
vAPI.net.onHeadersReceived = {
|
|
urls: [
|
|
'http://*/*',
|
|
'https://*/*'
|
|
],
|
|
types: [
|
|
'main_frame',
|
|
'sub_frame',
|
|
'image',
|
|
'media',
|
|
'script'
|
|
],
|
|
extra: [ 'blocking', 'responseHeaders' ],
|
|
callback: onHeadersReceived
|
|
};
|
|
|
|
vAPI.net.registerListeners();
|
|
|
|
//console.log('traffic.js > Beginning to intercept net requests at %s', (new Date()).toISOString());
|
|
|
|
/******************************************************************************/
|
|
|
|
var isTemporarilyWhitelisted = function(result, hostname) {
|
|
var obsolete, pos;
|
|
|
|
for (;;) {
|
|
obsolete = documentWhitelists[hostname];
|
|
if ( obsolete !== undefined ) {
|
|
if ( obsolete > Date.now() ) {
|
|
if ( result === '' ) {
|
|
return 'ua:*' + ' ' + hostname + ' doc allow';
|
|
}
|
|
} else {
|
|
delete documentWhitelists[hostname];
|
|
}
|
|
}
|
|
pos = hostname.indexOf('.');
|
|
if ( pos === -1 ) {
|
|
break;
|
|
}
|
|
hostname = hostname.slice(pos + 1);
|
|
}
|
|
return result;
|
|
};
|
|
|
|
var documentWhitelists = Object.create(null);
|
|
|
|
/******************************************************************************/
|
|
|
|
exports.temporarilyWhitelistDocument = function(hostname) {
|
|
if ( typeof hostname !== 'string' || hostname === '' ) {
|
|
return;
|
|
}
|
|
|
|
documentWhitelists[hostname] = Date.now() + 60 * 1000;
|
|
};
|
|
|
|
/******************************************************************************/
|
|
|
|
return exports;
|
|
|
|
/******************************************************************************/
|
|
|
|
})();
|
|
|
|
/******************************************************************************/
|