1// Copyright (C) 2018 The Android Open Source Project 2// 3// Licensed under the Apache License, Version 2.0 (the "License"); 4// you may not use this file except in compliance with the License. 5// You may obtain a copy of the License at 6// 7// http://www.apache.org/licenses/LICENSE-2.0 8// 9// Unless required by applicable law or agreed to in writing, software 10// distributed under the License is distributed on an "AS IS" BASIS, 11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12// See the License for the specific language governing permissions and 13// limitations under the License. 14 15import {RECORDING_V2_FLAG} from '../core/feature_flags'; 16import {globals} from '../frontend/globals'; 17 18import {Child, Controller, ControllerInitializerAny} from './controller'; 19import {RecordController} from './record_controller'; 20import {TraceController} from './trace_controller'; 21 22// The root controller for the entire app. It handles the lifetime of all 23// the other controllers (e.g., track and query controllers) according to the 24// global state. 25export class AppController extends Controller<'main'> { 26 // extensionPort is needed for the RecordController to communicate with the 27 // extension through the frontend. This is because the controller is running 28 // on a worker, and isn't able to directly send messages to the extension. 29 private extensionPort: MessagePort; 30 31 constructor(extensionPort: MessagePort) { 32 super('main'); 33 this.extensionPort = extensionPort; 34 } 35 36 // This is the root method that is called every time the controller tree is 37 // re-triggered. This can happen due to: 38 // - An action received from the frontend. 39 // - An internal promise of a nested controller being resolved and manually 40 // re-triggering the controllers. 41 run() { 42 const childControllers: ControllerInitializerAny[] = []; 43 if (!RECORDING_V2_FLAG.get()) { 44 childControllers.push( 45 Child('record', RecordController, {extensionPort: this.extensionPort}), 46 ); 47 } 48 if (globals.state.engine !== undefined) { 49 const engineCfg = globals.state.engine; 50 childControllers.push(Child(engineCfg.id, TraceController, engineCfg.id)); 51 } 52 return childControllers; 53 } 54} 55