mirror of
https://github.com/shaka-project/shaka-player.git
synced 2026-06-15 16:06:41 +03:00
Aaron Vaage
b27b649f6f
Created a static method that will handle destroying a destroyable object when you are done with it. Issue #1248 Change-Id: I4df0569f5f5e00002600702cf24caf1ed2da7c5b
60 lines
1.8 KiB
JavaScript
60 lines
1.8 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.IDestroyable');
|
|
|
|
|
|
|
|
/**
|
|
* An interface to standardize how objects are destroyed.
|
|
* @interface
|
|
* @exportInterface
|
|
*/
|
|
shaka.util.IDestroyable = function() {};
|
|
|
|
|
|
/**
|
|
* Destroys the object, releasing all resources and shutting down all
|
|
* operations. Returns a Promise which is resolved when destruction is
|
|
* complete. This Promise should never be rejected.
|
|
*
|
|
* @return {!Promise}
|
|
* @exportInterface
|
|
*/
|
|
shaka.util.IDestroyable.prototype.destroy = function() {};
|
|
|
|
|
|
/**
|
|
* A helper function that will destroy a destroyable object once
|
|
* the callback (and its promises) complete. The destroyable object
|
|
* will be destroyed regardless of whether or not the callback (and
|
|
* its promises) get resolved or rejected.
|
|
*
|
|
* @param {!shaka.util.IDestroyable} obj The destroyable object that
|
|
* should be destroyed after the callback completes.
|
|
* @param {function():!Promise<T>|function():T} callback
|
|
* @return {!Promise.<T>}
|
|
* @template T
|
|
*/
|
|
shaka.util.IDestroyable.with = function(obj, callback) {
|
|
let r = callback();
|
|
|
|
return Promise.resolve(r).then(
|
|
(r) => obj.destroy().then(() => r),
|
|
(e) => obj.destroy().then(() => { throw e; }));
|
|
};
|