fune/devtools/server/performance/framerate.js
Julian Descottes ffc364ee02 Bug 1391562 - use obj.on/off/emit rather than static methods from devtools event-emitter;r=zer0
MozReview-Commit-ID: I50W8zGB9d0

--HG--
extra : rebase_source : 31b687343461a65fc6a40eece461bc2367d596d7
2017-08-18 17:05:04 +02:00

99 lines
2.6 KiB
JavaScript

/* 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
* file, You can obtain one at http://mozilla.org/MPL/2.0/. */
"use strict";
/**
* A very simple utility for monitoring framerate. Takes a `tabActor`
* and monitors framerate over time. The actor wrapper around this
* can be found at devtools/server/actors/framerate.js
*/
class Framerate {
constructor(tabActor) {
this.tabActor = tabActor;
this._contentWin = tabActor.window;
this._onRefreshDriverTick = this._onRefreshDriverTick.bind(this);
this._onGlobalCreated = this._onGlobalCreated.bind(this);
this.tabActor.on("window-ready", this._onGlobalCreated);
}
destroy(conn) {
this.tabActor.off("window-ready", this._onGlobalCreated);
this.stopRecording();
}
/**
* Starts monitoring framerate, storing the frames per second.
*/
startRecording() {
if (this._recording) {
return;
}
this._recording = true;
this._ticks = [];
this._startTime = this.tabActor.docShell.now();
this._rafID = this._contentWin.requestAnimationFrame(this._onRefreshDriverTick);
}
/**
* Stops monitoring framerate, returning the recorded values.
*/
stopRecording(beginAt = 0, endAt = Number.MAX_SAFE_INTEGER) {
if (!this._recording) {
return [];
}
let ticks = this.getPendingTicks(beginAt, endAt);
this.cancelRecording();
return ticks;
}
/**
* Stops monitoring framerate, without returning the recorded values.
*/
cancelRecording() {
this._contentWin.cancelAnimationFrame(this._rafID);
this._recording = false;
this._ticks = null;
this._rafID = -1;
}
/**
* Returns whether this instance is currently recording.
*/
isRecording() {
return !!this._recording;
}
/**
* Gets the refresh driver ticks recorded so far.
*/
getPendingTicks(beginAt = 0, endAt = Number.MAX_SAFE_INTEGER) {
if (!this._ticks) {
return [];
}
return this._ticks.filter(e => e >= beginAt && e <= endAt);
}
/**
* Function invoked along with the refresh driver.
*/
_onRefreshDriverTick() {
if (!this._recording) {
return;
}
this._rafID = this._contentWin.requestAnimationFrame(this._onRefreshDriverTick);
this._ticks.push(this.tabActor.docShell.now() - this._startTime);
}
/**
* When the content window for the tab actor is created.
*/
_onGlobalCreated(win) {
if (this._recording) {
this._contentWin.cancelAnimationFrame(this._rafID);
this._rafID = this._contentWin.requestAnimationFrame(this._onRefreshDriverTick);
}
}
}
exports.Framerate = Framerate;