DevTools: Diff subsystem

third_party/WebKit/Source/devtools/front_end/workspace_diff/UISourceCodeDiff.js

+// Copyright 2017 The Chromium Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+/**
+ * @param {!Workspace.UISourceCode} uiSourceCode
+ * @return {!Promise<!Diff.Diff.DiffArray>}
+ */
+WorkspaceDiff.requestDiff = function(uiSourceCode) {

[lushnikov, 2017/03/09 00:09:25]

Let's do WorkspaceDiff.workspaceDiff().requestDiff(..) and put all the API in
there

and rename the filename

[einbinder, 2017/03/09 21:07:20]

Done.

+  return WorkspaceDiff._uiSourceCodeDiff(uiSourceCode).requestDiff();
+};
+
+/**
+ * @param {!Workspace.UISourceCode} uiSourceCode
+ * @param {function(!WorkspaceDiff.DiffChangedEvent)} callback
+ * @param {!Object=} thisObj
+ */
+WorkspaceDiff.subscribeToDiffChange = function(uiSourceCode, callback, thisObj) {
+  WorkspaceDiff._uiSourceCodeDiff(uiSourceCode).on(WorkspaceDiff.DiffChangedEvent, callback, thisObj);
+};
+
+/**
+ * @param {!Workspace.UISourceCode} uiSourceCode
+ * @param {function(!WorkspaceDiff.DiffChangedEvent)} callback
+ * @param {!Object=} thisObj
+ */
+WorkspaceDiff.unsubscribeToDiffChange = function(uiSourceCode, callback, thisObj) {
+  WorkspaceDiff._uiSourceCodeDiff(uiSourceCode).off(WorkspaceDiff.DiffChangedEvent, callback, thisObj);
+};
+
+/**
+ * @param {!Workspace.UISourceCode} uiSourceCode
+ * @return {!WorkspaceDiff._UISourceCodeDiff}
+ */
+WorkspaceDiff._uiSourceCodeDiff = function(uiSourceCode) {
+  if (!uiSourceCode[WorkspaceDiff._uiSourceCodeDiff.Symbol])
+    uiSourceCode[WorkspaceDiff._UISourceCodeDiff.Symbol] = new WorkspaceDiff._UISourceCodeDiff(uiSourceCode);
+  return uiSourceCode[WorkspaceDiff._UISourceCodeDiff.Symbol];
+};
+
+WorkspaceDiff._UISourceCodeDiff = class extends Common.Object {
+  /**
+   * @param {!Workspace.UISourceCode} uiSourceCode
+   */
+  constructor(uiSourceCode) {
+    super();
+    this._uiSourceCode = uiSourceCode;
+    uiSourceCode.addEventListener(Workspace.UISourceCode.Events.WorkingCopyChanged, this._uiSourceCodeChanged, this);
+    uiSourceCode.addEventListener(Workspace.UISourceCode.Events.WorkingCopyCommitted, this._uiSourceCodeChanged, this);
+    this._requestDiffPromise = null;
+    this._pendingChanges = null;
+  }
+
+  _uiSourceCodeChanged() {
+    if (this._pendingChanges) {
+      clearTimeout(this._pendingChanges);
+      this._pendingChanges = null;
+    }
+    this._requestDiffPromise = null;
+
+    var content = this._uiSourceCode.content();
+    var delay = (!content || content.length < 65536) ? 0 : 200;

[lushnikov, 2017/03/09 00:09:25]

extract 200 into constant

[einbinder, 2017/03/09 21:07:20]

Done.

+    this._pendingChanges = setTimeout(emitDiffChanged.bind(this), delay);
+
+    /**
+     * @this {WorkspaceDiff._UISourceCodeDiff}
+     */
+    function emitDiffChanged() {
+      this.emit(new WorkspaceDiff.DiffChangedEvent());
+      this._pendingChanges = null;
+    }
+  }
+
+  /**
+   * @return {!Promise<!Diff.Diff.DiffArray>}
+   */
+  requestDiff() {
+    if (!this._requestDiffPromise) {
+      this._requestDiffPromise = this._uiSourceCode.requestOriginalContent().then(baseline => {
+        var current = this._uiSourceCode.workingCopy();
+        var diff = Diff.Diff.lineDiff(baseline.split('\n'), current.split('\n'));
+        return diff || [];
+      });
+    }
+    return this._requestDiffPromise;
+  }
+};
+
+/**
+ * @implements {Common.Emittable}
+ */
+WorkspaceDiff.DiffChangedEvent = class {};
+
+WorkspaceDiff._UISourceCodeDiff.Symbol = Symbol('WorkspaceDiff._UISourceCodeDiff.Symbol');