mirror of
https://github.com/shaka-project/shaka-player.git
synced 2026-06-25 17:45:03 +03:00
Joey Parrish
bb646befca
Some of these issues were found by the Closure Compiler linter, which we are not currently using here. I will try to re-enable it in a follow-up change. Change-Id: Ie6e75f2b5a1e0f888c3dfbc78ed9cf254d2738bb
102 lines
2.9 KiB
JavaScript
102 lines
2.9 KiB
JavaScript
/**
|
|
* @license
|
|
* Copyright 2016 Google Inc.
|
|
*
|
|
* 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
|
|
*
|
|
* http://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.
|
|
*/
|
|
|
|
goog.provide('shaka.util.Destroyer');
|
|
|
|
goog.require('shaka.util.IDestroyable');
|
|
goog.require('shaka.util.PublicPromise');
|
|
|
|
|
|
/**
|
|
* A utility class to help work with |shaka.util.IDestroyable| objects.
|
|
*
|
|
* @final
|
|
*/
|
|
shaka.util.Destroyer = class {
|
|
/**
|
|
* @param {function():!Promise} callback
|
|
* A callback to destroy an object. This callback will only be called once
|
|
* regardless of how many times |destroy| is called.
|
|
*/
|
|
constructor(callback) {
|
|
/** @private {boolean} */
|
|
this.destroyed_ = false;
|
|
|
|
/** @private {!shaka.util.PublicPromise} */
|
|
this.waitOnDestroy_ = new shaka.util.PublicPromise();
|
|
|
|
/** @private {function():!Promise} */
|
|
this.onDestroy_ = callback;
|
|
}
|
|
|
|
/**
|
|
* Check if |destroy| has been called. This returning |true| does not mean
|
|
* that the promise returned by |destroy| has resolved yet.
|
|
*
|
|
* @return {boolean}
|
|
* @final
|
|
*/
|
|
destroyed() {
|
|
return this.destroyed_;
|
|
}
|
|
|
|
/**
|
|
* Request that the destroy callback be called. Will return a promise that
|
|
* will resolve once the callback terminates. The promise will never be
|
|
* rejected.
|
|
*
|
|
* @return {!Promise}
|
|
* @final
|
|
*/
|
|
destroy() {
|
|
if (this.destroyed_) {
|
|
return this.waitOnDestroy_;
|
|
}
|
|
|
|
// We have started destroying this object, so we should never get here
|
|
// again.
|
|
this.destroyed_ = true;
|
|
|
|
return this.onDestroy_().then(
|
|
() => { this.waitOnDestroy_.resolve(); },
|
|
() => { this.waitOnDestroy_.resolve(); });
|
|
}
|
|
|
|
/**
|
|
* A helper function to call |destroy| on |shaka.util.IDestroyable| objects
|
|
* in |objs| after |callback| terminates. All objects in |objs| will have
|
|
* |destroy| called regardless if |callback| is resolved or is rejected.
|
|
*
|
|
* @param {!Array.<!shaka.util.IDestroyable>} objs
|
|
* A list of destroyable objects that should be destroyed after the
|
|
* callback completes.
|
|
* @param {function():!Promise<T>|function():T} callback
|
|
* A callback that should perform actions on the objects in |objs|. When
|
|
* the promise returned by this callback is resolved or is rejected, all
|
|
* objects in |objs| will have |destroy| called.
|
|
* @return {!Promise.<T>}
|
|
* @template T
|
|
*/
|
|
static async with(objs, callback) {
|
|
try {
|
|
return await Promise.resolve(callback());
|
|
} finally {
|
|
await Promise.all(objs.map((obj) => obj.destroy()));
|
|
}
|
|
}
|
|
};
|