pkg/observatory/lib/src/elements/object_common.dart

// Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
// for details. All rights reserved. Use of this source code is governed by a
// BSD-style license that can be found in the LICENSE file.

import 'dart:async';

import 'package:web/web.dart';

import '../../models.dart' as M;
import 'class_ref.dart';
import 'helpers/custom_element.dart';
import 'helpers/element_utils.dart';
import 'helpers/rendering_scheduler.dart';
import 'inbound_references.dart';
import 'retaining_path.dart';
import 'sentinel_value.dart';
import '../../utils.dart';

class ObjectCommonElement extends CustomElement implements Renderable {
  late RenderingScheduler<ObjectCommonElement> _r;

  Stream<RenderedEvent<ObjectCommonElement>> get onRendered => _r.onRendered;

  late M.IsolateRef _isolate;
  late M.Object _object;
  late M.RetainedSizeRepository _retainedSizes;
  late M.ReachableSizeRepository _reachableSizes;
  late M.InboundReferencesRepository _references;
  late M.RetainingPathRepository _retainingPaths;
  late M.ObjectRepository _objects;
  M.Guarded<M.Instance>? _retainedSize = null;
  bool _loadingRetainedBytes = false;
  M.Guarded<M.Instance>? _reachableSize = null;
  bool _loadingReachableBytes = false;

  M.IsolateRef get isolate => _isolate;
  M.Object get object => _object;

  factory ObjectCommonElement(
    M.IsolateRef isolate,
    M.Object object,
    M.RetainedSizeRepository retainedSizes,
    M.ReachableSizeRepository reachableSizes,
    M.InboundReferencesRepository references,
    M.RetainingPathRepository retainingPaths,
    M.ObjectRepository objects, {
    RenderingQueue? queue,
  }) {
    ObjectCommonElement e = new ObjectCommonElement.created();
    e._r = new RenderingScheduler<ObjectCommonElement>(e, queue: queue);
    e._isolate = isolate;
    e._object = object;
    e._retainedSizes = retainedSizes;
    e._reachableSizes = reachableSizes;
    e._references = references;
    e._objects = objects;
    e._retainingPaths = retainingPaths;
    return e;
  }

  ObjectCommonElement.created() : super.created('object-common');

  @override
  void attached() {
    super.attached();
    _r.enable();
  }

  @override
  void detached() {
    super.detached();
    _r.disable(notify: true);
    removeChildren();
  }

  RetainingPathElement? _path;
  InboundReferencesElement? _inbounds;

  void render() {
    _path =
        _path ??
        new RetainingPathElement(
          _isolate,
          _object,
          _retainingPaths,
          _objects,
          queue: _r.queue,
        );
    _inbounds =
        _inbounds ??
        new InboundReferencesElement(
          _isolate,
          _object,
          _references,
          _objects,
          queue: _r.queue,
        );
    children = <HTMLElement>[
      new HTMLDivElement()
        ..className = 'memberList'
        ..appendChildren(<HTMLElement>[
          new HTMLDivElement()
            ..className = 'memberItem'
            ..appendChildren(<HTMLElement>[
              new HTMLDivElement()
                ..className = 'memberName'
                ..textContent = 'Class ',
              new HTMLDivElement()
                ..className = 'memberValue'
                ..appendChildren(<HTMLElement>[
                  _object.clazz == null
                      ? (new HTMLSpanElement()..textContent = '...')
                      : new ClassRefElement(
                          _isolate,
                          _object.clazz!,
                          queue: _r.queue,
                        ).element,
                ]),
            ]),
          new HTMLDivElement()
            ..className = 'memberItem'
            ..title = 'Space for this object in memory'
            ..appendChildren(<HTMLElement>[
              new HTMLDivElement()
                ..className = 'memberName'
                ..textContent = 'Shallow size ',
              new HTMLDivElement()
                ..className = 'memberValue'
                ..textContent = Utils.formatSize(_object.size ?? 0),
            ]),
          new HTMLDivElement()
            ..className = 'memberItem'
            ..title =
                'Space reachable from this object, '
                'excluding class references'
            ..appendChildren(<HTMLElement>[
              new HTMLDivElement()
                ..className = 'memberName'
                ..textContent = 'Reachable size ',
              new HTMLDivElement()
                ..className = 'memberValue'
                ..appendChildren(_createReachableSizeValue()),
            ]),
          new HTMLDivElement()
            ..className = 'memberItem'
            ..title =
                'Space that would be reclaimed if references to this '
                'object were replaced with null'
            ..appendChildren(<HTMLElement>[
              new HTMLDivElement()
                ..className = 'memberName'
                ..textContent = 'Retained size ',
              new HTMLDivElement()
                ..className = 'memberValue'
                ..appendChildren(_createRetainedSizeValue()),
            ]),
          new HTMLDivElement()
            ..className = 'memberItem'
            ..appendChildren(<HTMLElement>[
              new HTMLDivElement()
                ..className = 'memberName'
                ..textContent = 'Retaining path ',
              new HTMLDivElement()
                ..className = 'memberValue'
                ..appendChildren(<HTMLElement>[_path!.element]),
            ]),
          new HTMLDivElement()
            ..className = 'memberItem'
            ..title = 'Objects which directly reference this object'
            ..appendChildren(<HTMLElement>[
              new HTMLDivElement()
                ..className = 'memberName'
                ..textContent = 'Inbound references ',
              new HTMLDivElement()
                ..className = 'memberValue'
                ..appendChildren(<HTMLElement>[_inbounds!.element]),
            ]),
        ]),
    ];
  }

  List<HTMLElement> _createReachableSizeValue() {
    final content = <HTMLElement>[];
    if (_reachableSize != null) {
      if (_reachableSize!.isSentinel) {
        content.add(
          new SentinelValueElement(
            _reachableSize!.asSentinel!,
            queue: _r.queue,
          ).element,
        );
      } else {
        content.add(
          new HTMLSpanElement()
            ..textContent = Utils.formatSize(
              int.parse(_reachableSize!.asValue!.valueAsString!),
            ),
        );
      }
    } else {
      content.add(new HTMLSpanElement()..textContent = '...');
    }
    final button = new HTMLButtonElement()
      ..className = 'reachable_size'
      ..disabled = _loadingReachableBytes
      ..textContent = '↺';
    button.onClick.listen((_) async {
      button.disabled = true;
      _loadingReachableBytes = true;
      _reachableSize = await _reachableSizes.get(_isolate, _object.id!);
      _r.dirty();
    });
    content.add(button);
    return content;
  }

  List<HTMLElement> _createRetainedSizeValue() {
    final content = <HTMLElement>[];
    if (_retainedSize != null) {
      if (_retainedSize!.isSentinel) {
        content.add(
          new SentinelValueElement(
            _retainedSize!.asSentinel!,
            queue: _r.queue,
          ).element,
        );
      } else {
        content.add(
          new HTMLSpanElement()
            ..textContent = Utils.formatSize(
              int.parse(_retainedSize!.asValue!.valueAsString!),
            ),
        );
      }
    } else {
      content.add(new HTMLSpanElement()..textContent = '...');
    }
    final button = new HTMLButtonElement()
      ..className = 'retained_size'
      ..disabled = _loadingRetainedBytes
      ..textContent = '↺';
    button.onClick.listen((_) async {
      button.disabled = true;
      _loadingRetainedBytes = true;
      _retainedSize = await _retainedSizes.get(_isolate, _object.id!);
      _r.dirty();
    });
    content.add(button);
    return content;
  }
}