81 lines
3.0 KiB
JavaScript
81 lines
3.0 KiB
JavaScript
"use strict";
|
|
/*
|
|
* Copyright The OpenTelemetry Authors
|
|
*
|
|
* Licensed under the Apache License, Version 2.0 (the "License");
|
|
* you may not use this file except in compliance with the License.
|
|
* You may obtain a copy of the License at
|
|
*
|
|
* https://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
exports.ContextAPI = void 0;
|
|
const NoopContextManager_1 = require("../context/NoopContextManager");
|
|
const global_utils_1 = require("../internal/global-utils");
|
|
const diag_1 = require("./diag");
|
|
const API_NAME = 'context';
|
|
const NOOP_CONTEXT_MANAGER = new NoopContextManager_1.NoopContextManager();
|
|
/**
|
|
* Singleton object which represents the entry point to the OpenTelemetry Context API
|
|
*/
|
|
class ContextAPI {
|
|
/** Empty private constructor prevents end users from constructing a new instance of the API */
|
|
constructor() { }
|
|
/** Get the singleton instance of the Context API */
|
|
static getInstance() {
|
|
if (!this._instance) {
|
|
this._instance = new ContextAPI();
|
|
}
|
|
return this._instance;
|
|
}
|
|
/**
|
|
* Set the current context manager.
|
|
*
|
|
* @returns true if the context manager was successfully registered, else false
|
|
*/
|
|
setGlobalContextManager(contextManager) {
|
|
return (0, global_utils_1.registerGlobal)(API_NAME, contextManager, diag_1.DiagAPI.instance());
|
|
}
|
|
/**
|
|
* Get the currently active context
|
|
*/
|
|
active() {
|
|
return this._getContextManager().active();
|
|
}
|
|
/**
|
|
* Execute a function with an active context
|
|
*
|
|
* @param context context to be active during function execution
|
|
* @param fn function to execute in a context
|
|
* @param thisArg optional receiver to be used for calling fn
|
|
* @param args optional arguments forwarded to fn
|
|
*/
|
|
with(context, fn, thisArg, ...args) {
|
|
return this._getContextManager().with(context, fn, thisArg, ...args);
|
|
}
|
|
/**
|
|
* Bind a context to a target function or event emitter
|
|
*
|
|
* @param context context to bind to the event emitter or function. Defaults to the currently active context
|
|
* @param target function or event emitter to bind
|
|
*/
|
|
bind(context, target) {
|
|
return this._getContextManager().bind(context, target);
|
|
}
|
|
_getContextManager() {
|
|
return (0, global_utils_1.getGlobal)(API_NAME) || NOOP_CONTEXT_MANAGER;
|
|
}
|
|
/** Disable and remove the global context manager */
|
|
disable() {
|
|
this._getContextManager().disable();
|
|
(0, global_utils_1.unregisterGlobal)(API_NAME, diag_1.DiagAPI.instance());
|
|
}
|
|
}
|
|
exports.ContextAPI = ContextAPI;
|
|
//# sourceMappingURL=context.js.map
|