• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1/*
2 * Copyright (c) 2021-2022 Huawei Device Co., Ltd.
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 */
15
16import { AsyncCallback } from "../basic";
17import ExtensionContext from "./ExtensionContext";
18import formBindingData from '../@ohos.app.form.formBindingData';
19import Want from '../@ohos.app.ability.Want';
20
21/**
22 * The context of form extension. It allows access to
23 * formExtension-specific resources.
24 * @syscap SystemCapability.Ability.Form
25 * @StageModelOnly
26 * @since 9
27 */
28export default class FormExtensionContext extends ExtensionContext {
29    /**
30     * Start an ability within the same bundle.
31     * @param { Want } want - includes ability name, parameters and relative info sending to an ability.
32     * @param { AsyncCallback<void> } callback - The callback of startAbility.
33     * @throws { BusinessError } 202 - The application is not a system application.
34     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
35     * @throws { BusinessError } 16500050 - An IPC connection error happened.
36     * @throws { BusinessError } 16500100 - Failed to obtain the configuration information.
37     * @throws { BusinessError } 16500101 - The application is not a system application.
38     * @throws { BusinessError } 16501000 - An internal functional error occurred.
39     * @syscap SystemCapability.Ability.Form
40     * @systemapi
41     * @StageModelOnly
42     * @since 9
43     */
44    startAbility(want: Want, callback: AsyncCallback<void>): void;
45
46    /**
47     * Start an ability within the same bundle.
48     * @param { Want } want - includes ability name, parameters and relative info sending to an ability.
49     * @returns { Promise<void> } The promise returned by the function.
50     * @throws { BusinessError } 202 - The application is not a system application.
51     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
52     * @throws { BusinessError } 16500050 - An IPC connection error happened.
53     * @throws { BusinessError } 16500100 - Failed to obtain the configuration information.
54     * @throws { BusinessError } 16500101 - The application is not a system application.
55     * @throws { BusinessError } 16501000 - An internal functional error occurred.
56     * @syscap SystemCapability.Ability.Form
57     * @systemapi
58     * @StageModelOnly
59     * @since 9
60     */
61    startAbility(want: Want): Promise<void>;
62}
63