sdk/testing/sl4f/client/lib/src/component.dart

// Copyright 2020 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

import 'sl4f_client.dart';

/// Interact with the Components of the system.
class Component {
  final Sl4f _sl4f;

  Component(this._sl4f);

  /// List currently running components in the device.
  Future<List<String>> list() async {
    final result = await _sl4f.request('component_facade.List');
    return result.cast<String>();
  }

  /// Returns true if the component [name] is currently running.
  ///
  /// [name] is the exact name of the component, like 'component.cmx'.
  Future<bool> search(String name) async {
    final result =
        await _sl4f.request('component_facade.Search', {'name': name});
    return result == 'Success';
  }

  /// Launches a component given by [url]
  ///
  /// [url] can be of the form "fuchsia-pkg://url.to/component#meta/component.cmx"
  /// or can also be given as just "component.cmx" in which case it'll be
  /// converted to a fuchsia-pkg url for fuchsia.com packages.
  Future<dynamic> launch(String url, [List<String> args]) async {
    var packageUrl = url;
    if (!url.startsWith('fuchsia-pkg')) {
      packageUrl = 'fuchsia-pkg://fuchsia.com/$url#meta/$url.cmx';
    }
    if (args != null && args.isNotEmpty) {
      return await _sl4f.request(
          'component_facade.Launch', {'url': packageUrl, 'arguments': args});
    }
    return await _sl4f.request('component_facade.Launch', {'url': packageUrl});
  }
}