Source code
Revision control
Copy as Markdown
Other Tools
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
export const BYTES_IN_KILOBYTE = 1000;
export const BYTES_IN_MEGABYTE = 1000000;
export const BYTES_IN_KIBIBYTE = 1024;
export const BYTES_IN_MEBIBYTE = 1048576;
export const MeasurementUtils = {
/**
* Rounds byte sizes of user files in order to provide protection
* against fingerprinting.
*
* @param {number} bytes
* Number of bytes to fuzz
* @param {number} nearest
* Nearest number of bytes to round to
* @returns {number}
* Number of bytes rounded to the `nearest` granularity
*
* @example fuzzByteSize(1500, 1000) === 2000
* @example fuzzByteSize(1001, 1000) === 1000
* @example fuzzByteSize(1024, 10) === 1020
* @example fuzzByteSize(512, 1000) === 1000
* @example fuzzByteSize(256, 1000) === 1000
*/
fuzzByteSize(bytes, nearest) {
const fuzzed = Math.round(bytes / nearest) * nearest;
return Math.max(fuzzed, nearest);
},
/**
* Helper wrapper for timing an async operation with Glean. This style of
* helper is available in some Glean SDKs, but not JavaScript yet.
*
*
* @template T
* @param {GleanTimingDistribution} timer
* Glean TimingDistribution object
* @param {Promise<T>} operation
* Async operation to time
* @returns {Promise<T>}
* Result of `operation`
*/
async measure(timer, operation) {
const timerId = timer.start();
try {
const result = await operation;
timer.stopAndAccumulate(timerId);
return result;
} catch (err) {
timer.cancel(timerId);
throw err;
}
},
};