overrides.js

  1. export var array_overrides = {};
  2. export var operation_overrides = {};
  4. function registerHandler(key, handler, overrides) {
  5.     if (key in overrides) {
  6.         let old = overrides[key];
  7.         if (handler == null){
  8.             delete overrides[key];
  9.         } else {
  10.             overrides[key] = handler;
  11.         }
  12.         return old;
  13.     }
  15.     if (handler !== null) {
  16.         overrides[key] = handler;
  17.     }
  18.     return null;
  19. }
  21. /**
  22.  * Get or set custom handlers for arrays in a **chihaya**-formatted HDF5 file.
  23.  *
  24.  * @param {string} array - Type of the delayed array, matched against the `delayed_array` attribute.
  25.  * @param {?function} handler - Handler function that accepts a HDF5 group handle (corresponding to the array) and returns a {@linkplain external:ScranMatrix ScranMatrix} object.
  26.  * Handlers may be async.
  27.  * If `null`, any custom handler was previously registered will be removed.
  28.  *
  29.  * @return {?function} The previously registered handler function, or `null` if no handler was previously registered.
  30.  */
  31. export function registerArrayHandler(array, handler) {
  32.     return registerHandler(array, handler, array_overrides);
  33. }
  35. /**
  36.  * Get or set custom handlers for delayed operations in a **chihaya**-formatted HDF5 file.
  37.  *
  38.  * @param {string} operation - Type of the delayed operation, matched against the `delayed_operation` attribute.
  39.  * @param {?function} handler - Handler function that accepts a HDF5 group handle (corresponding to the delayed operation) and returns a {@linkplain external:ScranMatrix ScranMatrix} object.
  40.  * Handlers may be async.
  41.  * If `null`, any custom handler was previously registered will be removed.
  42.  *
  43.  * @return {?function} The previously registered handler function, or `null` if no handler was previously registered.
  44.  */
  45. export function registerOperationHandler(operation, handler) {
  46.     return registerHandler(operation, handler, operation_overrides);
  47. }