161847f8eSopenharmony_ci/*
261847f8eSopenharmony_ci * Copyright (C) 2021-2023 Huawei Device Co., Ltd.
361847f8eSopenharmony_ci * Licensed under the Apache License, Version 2.0 (the "License");
461847f8eSopenharmony_ci * you may not use this file except in compliance with the License.
561847f8eSopenharmony_ci * You may obtain a copy of the License at
661847f8eSopenharmony_ci *
761847f8eSopenharmony_ci *     http://www.apache.org/licenses/LICENSE-2.0
861847f8eSopenharmony_ci *
961847f8eSopenharmony_ci * Unless required by applicable law or agreed to in writing, software
1061847f8eSopenharmony_ci * distributed under the License is distributed on an "AS IS" BASIS,
1161847f8eSopenharmony_ci * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
1261847f8eSopenharmony_ci * See the License for the specific language governing permissions and
1361847f8eSopenharmony_ci * limitations under the License.
1461847f8eSopenharmony_ci */
1561847f8eSopenharmony_ci
1661847f8eSopenharmony_ci/**
1761847f8eSopenharmony_ci * @file
1861847f8eSopenharmony_ci * @kit ContactsKit
1961847f8eSopenharmony_ci */
2061847f8eSopenharmony_ci
2161847f8eSopenharmony_ciimport { AsyncCallback } from './@ohos.base';
2261847f8eSopenharmony_ciimport type Context from './application/BaseContext';
2361847f8eSopenharmony_ci
2461847f8eSopenharmony_ci/**
2561847f8eSopenharmony_ci * Contains variety of system contact, provides functions for adding, updating and deleting these system contact
2661847f8eSopenharmony_ci * and provides methods for querying the information of contact.
2761847f8eSopenharmony_ci *
2861847f8eSopenharmony_ci * @namespace contact
2961847f8eSopenharmony_ci * @syscap SystemCapability.Applications.ContactsData
3061847f8eSopenharmony_ci * @since 7
3161847f8eSopenharmony_ci */
3261847f8eSopenharmony_ci/**
3361847f8eSopenharmony_ci * Contains variety of system contact, provides functions for adding, updating and deleting these system contact
3461847f8eSopenharmony_ci * and provides methods for querying the information of contact.
3561847f8eSopenharmony_ci *
3661847f8eSopenharmony_ci * @namespace contact
3761847f8eSopenharmony_ci * @syscap SystemCapability.Applications.ContactsData
3861847f8eSopenharmony_ci * @atomicservice
3961847f8eSopenharmony_ci * @since 11
4061847f8eSopenharmony_ci */
4161847f8eSopenharmony_cideclare namespace contact {
4261847f8eSopenharmony_ci  /**
4361847f8eSopenharmony_ci   * Creates a contact.
4461847f8eSopenharmony_ci   *
4561847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
4661847f8eSopenharmony_ci   * @param { Contact } contact - Indicates the contact information.
4761847f8eSopenharmony_ci   * @param { AsyncCallback<number> } callback - Returns the contact ID (which can be obtained
4861847f8eSopenharmony_ci   * by {@link Contact#getId()}) if the creation is successful. returns {@link Contact#INVALID_CONTACT_ID} if the
4961847f8eSopenharmony_ci   * creation fails.
5061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
5161847f8eSopenharmony_ci   * @since 7
5261847f8eSopenharmony_ci   * @deprecated since 10
5361847f8eSopenharmony_ci   * @useinstead contact.addContact#addContact
5461847f8eSopenharmony_ci   */
5561847f8eSopenharmony_ci  function addContact(contact: Contact, callback: AsyncCallback<number>): void;
5661847f8eSopenharmony_ci
5761847f8eSopenharmony_ci  /**
5861847f8eSopenharmony_ci   * Creates a contact.
5961847f8eSopenharmony_ci   *
6061847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
6161847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
6261847f8eSopenharmony_ci   * @param { Contact } contact - Indicates the contact information.
6361847f8eSopenharmony_ci   * @param { AsyncCallback<number> } callback - Returns the contact ID (which can be obtained
6461847f8eSopenharmony_ci   * by {@link Contact#getId()}) if the creation is successful. returns {@link Contact#INVALID_CONTACT_ID} if the
6561847f8eSopenharmony_ci   * creation fails.
6661847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
6761847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
6861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
6961847f8eSopenharmony_ci   * @since 10
7061847f8eSopenharmony_ci   */
7161847f8eSopenharmony_ci  /**
7261847f8eSopenharmony_ci   * Creates a contact.
7361847f8eSopenharmony_ci   *
7461847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
7561847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
7661847f8eSopenharmony_ci   * @param { Contact } contact - Indicates the contact information.
7761847f8eSopenharmony_ci   * @param { AsyncCallback<number> } callback - Returns the contact ID (which can be obtained
7861847f8eSopenharmony_ci   * by {@link Contact#getId()}) if the creation is successful. returns {@link Contact#INVALID_CONTACT_ID} if the
7961847f8eSopenharmony_ci   * creation fails.
8061847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
8161847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
8261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
8361847f8eSopenharmony_ci   * @atomicservice
8461847f8eSopenharmony_ci   * @since 12
8561847f8eSopenharmony_ci   */
8661847f8eSopenharmony_ci  function addContact(context: Context, contact: Contact, callback: AsyncCallback<number>): void;
8761847f8eSopenharmony_ci
8861847f8eSopenharmony_ci  /**
8961847f8eSopenharmony_ci   * Creates a contact.
9061847f8eSopenharmony_ci   *
9161847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
9261847f8eSopenharmony_ci   * @param { Contact } contact - Indicates the contact information.
9361847f8eSopenharmony_ci   * @returns { Promise<number> } Returns the contact ID (which can be obtained by {@link Contact#getId()}) if the
9461847f8eSopenharmony_ci   * creation is successful. returns {@link Contact#INVALID_CONTACT_ID} if the creation fails.
9561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
9661847f8eSopenharmony_ci   * @since 7
9761847f8eSopenharmony_ci   * @deprecated since 10
9861847f8eSopenharmony_ci   * @useinstead contact.addContact#addContact
9961847f8eSopenharmony_ci   */
10061847f8eSopenharmony_ci  function addContact(contact: Contact): Promise<number>;
10161847f8eSopenharmony_ci
10261847f8eSopenharmony_ci  /**
10361847f8eSopenharmony_ci   * Creates a contact.
10461847f8eSopenharmony_ci   *
10561847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
10661847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
10761847f8eSopenharmony_ci   * @param { Contact } contact - Indicates the contact information.
10861847f8eSopenharmony_ci   * @returns { Promise<number> } Returns the contact ID (which can be obtained by {@link Contact#getId()}) if the
10961847f8eSopenharmony_ci   * creation is successful. returns {@link Contact#INVALID_CONTACT_ID} if the creation fails.
11061847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
11161847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
11261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
11361847f8eSopenharmony_ci   * @since 10
11461847f8eSopenharmony_ci   */
11561847f8eSopenharmony_ci  /**
11661847f8eSopenharmony_ci   * Creates a contact.
11761847f8eSopenharmony_ci   *
11861847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
11961847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
12061847f8eSopenharmony_ci   * @param { Contact } contact - Indicates the contact information.
12161847f8eSopenharmony_ci   * @returns { Promise<number> } Returns the contact ID (which can be obtained by {@link Contact#getId()}) if the
12261847f8eSopenharmony_ci   * creation is successful. returns {@link Contact#INVALID_CONTACT_ID} if the creation fails.
12361847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
12461847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
12561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
12661847f8eSopenharmony_ci   * @atomicservice
12761847f8eSopenharmony_ci   * @since 12
12861847f8eSopenharmony_ci   */
12961847f8eSopenharmony_ci  function addContact(context: Context, contact: Contact): Promise<number>;
13061847f8eSopenharmony_ci
13161847f8eSopenharmony_ci  /**
13261847f8eSopenharmony_ci   * Select contact.
13361847f8eSopenharmony_ci   *
13461847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
13561847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Indicates the callback for getting the result of the call.
13661847f8eSopenharmony_ci   * Returns the contact list which user select; returns empty contact list if user not select.
13761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.Contacts
13861847f8eSopenharmony_ci   * @since 7
13961847f8eSopenharmony_ci   * @deprecated since 10
14061847f8eSopenharmony_ci   * @useinstead contact.selectContact#selectContacts
14161847f8eSopenharmony_ci   */
14261847f8eSopenharmony_ci  function selectContact(callback: AsyncCallback<Array<Contact>>): void;
14361847f8eSopenharmony_ci
14461847f8eSopenharmony_ci  /**
14561847f8eSopenharmony_ci   * Select contact.
14661847f8eSopenharmony_ci   *
14761847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Indicates the callback for getting the result of the call.
14861847f8eSopenharmony_ci   * Returns the contact list which user select; returns empty contact list if user not select.
14961847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
15061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.Contacts
15161847f8eSopenharmony_ci   * @since 10
15261847f8eSopenharmony_ci   */
15361847f8eSopenharmony_ci  /**
15461847f8eSopenharmony_ci   * Select contact.
15561847f8eSopenharmony_ci   *
15661847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Indicates the callback for getting the result of the call.
15761847f8eSopenharmony_ci   * Returns the contact list which user select; returns empty contact list if user not select.
15861847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
15961847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.Contacts
16061847f8eSopenharmony_ci   * @atomicservice
16161847f8eSopenharmony_ci   * @since 11
16261847f8eSopenharmony_ci   */
16361847f8eSopenharmony_ci  function selectContacts(callback: AsyncCallback<Array<Contact>>): void;
16461847f8eSopenharmony_ci
16561847f8eSopenharmony_ci  /**
16661847f8eSopenharmony_ci   * Select contact.
16761847f8eSopenharmony_ci   *
16861847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
16961847f8eSopenharmony_ci   * @returns { Promise<Array<Contact>> } Returns the contact list which user select;
17061847f8eSopenharmony_ci   * returns empty contact list if user not select.
17161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.Contacts
17261847f8eSopenharmony_ci   * @since 7
17361847f8eSopenharmony_ci   * @deprecated since 10
17461847f8eSopenharmony_ci   * @useinstead contact.selectContact#selectContacts
17561847f8eSopenharmony_ci   */
17661847f8eSopenharmony_ci  function selectContact(): Promise<Array<Contact>>;
17761847f8eSopenharmony_ci
17861847f8eSopenharmony_ci  /**
17961847f8eSopenharmony_ci   * Select contact.
18061847f8eSopenharmony_ci   *
18161847f8eSopenharmony_ci   * @returns { Promise<Array<Contact>> } Returns the contact list which user select;
18261847f8eSopenharmony_ci   * returns empty contact list if user not select.
18361847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.Contacts
18461847f8eSopenharmony_ci   * @since 10
18561847f8eSopenharmony_ci   */
18661847f8eSopenharmony_ci  /**
18761847f8eSopenharmony_ci   * Select contact.
18861847f8eSopenharmony_ci   *
18961847f8eSopenharmony_ci   * @returns { Promise<Array<Contact>> } Returns the contact list which user select;
19061847f8eSopenharmony_ci   * returns empty contact list if user not select.
19161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.Contacts
19261847f8eSopenharmony_ci   * @atomicservice
19361847f8eSopenharmony_ci   * @since 11
19461847f8eSopenharmony_ci   */
19561847f8eSopenharmony_ci  function selectContacts(): Promise<Array<Contact>>;
19661847f8eSopenharmony_ci
19761847f8eSopenharmony_ci  /**
19861847f8eSopenharmony_ci   * Select contact with option.
19961847f8eSopenharmony_ci   *
20061847f8eSopenharmony_ci   * @param { ContactSelectionOptions } options - Indicates the Single-select or multiple-select.
20161847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Indicates the callback for getting the result of the call.
20261847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
20361847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.Contacts
20461847f8eSopenharmony_ci   * @since 10
20561847f8eSopenharmony_ci   */
20661847f8eSopenharmony_ci  /**
20761847f8eSopenharmony_ci   * Select contact with option.
20861847f8eSopenharmony_ci   *
20961847f8eSopenharmony_ci   * @param { ContactSelectionOptions } options - Indicates the Single-select or multiple-select.
21061847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Indicates the callback for getting the result of the call.
21161847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
21261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.Contacts
21361847f8eSopenharmony_ci   * @atomicservice
21461847f8eSopenharmony_ci   * @since 11
21561847f8eSopenharmony_ci   */
21661847f8eSopenharmony_ci  function selectContacts(options: ContactSelectionOptions, callback: AsyncCallback<Array<Contact>>): void;
21761847f8eSopenharmony_ci
21861847f8eSopenharmony_ci  /**
21961847f8eSopenharmony_ci   * Select contact with option.
22061847f8eSopenharmony_ci   *
22161847f8eSopenharmony_ci   * @param { ContactSelectionOptions } options - Indicates the Single-select or multiple-select.
22261847f8eSopenharmony_ci   * @returns { Promise<Array<Contact>> } Returns the contact list which user select;
22361847f8eSopenharmony_ci   * returns empty contact list if user not select.
22461847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
22561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.Contacts
22661847f8eSopenharmony_ci   * @since 10
22761847f8eSopenharmony_ci   */
22861847f8eSopenharmony_ci  /**
22961847f8eSopenharmony_ci   * Select contact with option.
23061847f8eSopenharmony_ci   *
23161847f8eSopenharmony_ci   * @param { ContactSelectionOptions } options - Indicates the Single-select or multiple-select.
23261847f8eSopenharmony_ci   * @returns { Promise<Array<Contact>> } Returns the contact list which user select;
23361847f8eSopenharmony_ci   * returns empty contact list if user not select.
23461847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
23561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.Contacts
23661847f8eSopenharmony_ci   * @atomicservice
23761847f8eSopenharmony_ci   * @since 11
23861847f8eSopenharmony_ci   */
23961847f8eSopenharmony_ci  function selectContacts(options: ContactSelectionOptions): Promise<Array<Contact>>;
24061847f8eSopenharmony_ci
24161847f8eSopenharmony_ci  /**
24261847f8eSopenharmony_ci   * Deletes a specified contact.
24361847f8eSopenharmony_ci   *
24461847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
24561847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact to delete.
24661847f8eSopenharmony_ci   * @param { AsyncCallback<void> } callback - Return the callback function.
24761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
24861847f8eSopenharmony_ci   * @since 7
24961847f8eSopenharmony_ci   * @deprecated since 10
25061847f8eSopenharmony_ci   * @useinstead contact.deleteContact#deleteContact
25161847f8eSopenharmony_ci   */
25261847f8eSopenharmony_ci  function deleteContact(key: string, callback: AsyncCallback<void>): void;
25361847f8eSopenharmony_ci
25461847f8eSopenharmony_ci  /**
25561847f8eSopenharmony_ci   * Deletes a specified contact.
25661847f8eSopenharmony_ci   *
25761847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
25861847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
25961847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact to delete.
26061847f8eSopenharmony_ci   * @param { AsyncCallback<void> } callback - Return the callback function.
26161847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
26261847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
26361847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
26461847f8eSopenharmony_ci   * @since 10
26561847f8eSopenharmony_ci   */
26661847f8eSopenharmony_ci  function deleteContact(context: Context, key: string, callback: AsyncCallback<void>): void;
26761847f8eSopenharmony_ci
26861847f8eSopenharmony_ci  /**
26961847f8eSopenharmony_ci   * Deletes a specified contact.
27061847f8eSopenharmony_ci   *
27161847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
27261847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact to delete.
27361847f8eSopenharmony_ci   * @returns { Promise<void> } The promise returned by the function.
27461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
27561847f8eSopenharmony_ci   * @since 7
27661847f8eSopenharmony_ci   * @deprecated since 10
27761847f8eSopenharmony_ci   * @useinstead contact.deleteContact#deleteContact
27861847f8eSopenharmony_ci   */
27961847f8eSopenharmony_ci  function deleteContact(key: string): Promise<void>;
28061847f8eSopenharmony_ci
28161847f8eSopenharmony_ci  /**
28261847f8eSopenharmony_ci   * Deletes a specified contact.
28361847f8eSopenharmony_ci   *
28461847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
28561847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
28661847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact to delete.
28761847f8eSopenharmony_ci   * @returns { Promise<void> } The promise returned by the function.
28861847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
28961847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
29061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
29161847f8eSopenharmony_ci   * @since 10
29261847f8eSopenharmony_ci   */
29361847f8eSopenharmony_ci  function deleteContact(context: Context, key: string): Promise<void>;
29461847f8eSopenharmony_ci
29561847f8eSopenharmony_ci  /**
29661847f8eSopenharmony_ci   * Queries a specified contact of specified attributes.
29761847f8eSopenharmony_ci   *
29861847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
29961847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact.
30061847f8eSopenharmony_ci   * @param { AsyncCallback<Contact> } callback - Returns the specified contact.
30161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
30261847f8eSopenharmony_ci   * @since 7
30361847f8eSopenharmony_ci   * @deprecated since 10
30461847f8eSopenharmony_ci   * @useinstead contact.queryContact#queryContact
30561847f8eSopenharmony_ci   */
30661847f8eSopenharmony_ci  function queryContact(key: string, callback: AsyncCallback<Contact>): void;
30761847f8eSopenharmony_ci
30861847f8eSopenharmony_ci  /**
30961847f8eSopenharmony_ci   * Queries a specified contact of specified attributes.
31061847f8eSopenharmony_ci   *
31161847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
31261847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
31361847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact.
31461847f8eSopenharmony_ci   * @param { AsyncCallback<Contact> } callback - Returns the specified contact.
31561847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
31661847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
31761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
31861847f8eSopenharmony_ci   * @since 10
31961847f8eSopenharmony_ci   */
32061847f8eSopenharmony_ci  function queryContact(context: Context, key: string, callback: AsyncCallback<Contact>): void;
32161847f8eSopenharmony_ci
32261847f8eSopenharmony_ci  /**
32361847f8eSopenharmony_ci   * Queries a specified contact of specified attributes.
32461847f8eSopenharmony_ci   *
32561847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
32661847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact.
32761847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
32861847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
32961847f8eSopenharmony_ci   * @param { AsyncCallback<Contact> } callback - Returns the specified contact.
33061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
33161847f8eSopenharmony_ci   * @since 7
33261847f8eSopenharmony_ci   * @deprecated since 10
33361847f8eSopenharmony_ci   * @useinstead contact.queryContact#queryContact
33461847f8eSopenharmony_ci   */
33561847f8eSopenharmony_ci  function queryContact(key: string, holder: Holder, callback: AsyncCallback<Contact>): void;
33661847f8eSopenharmony_ci
33761847f8eSopenharmony_ci  /**
33861847f8eSopenharmony_ci   * Queries a specified contact of specified attributes.
33961847f8eSopenharmony_ci   *
34061847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
34161847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
34261847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact.
34361847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
34461847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
34561847f8eSopenharmony_ci   * @param { AsyncCallback<Contact> } callback - Returns the specified contact.
34661847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
34761847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
34861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
34961847f8eSopenharmony_ci   * @since 10
35061847f8eSopenharmony_ci   */
35161847f8eSopenharmony_ci  function queryContact(context: Context, key: string, holder: Holder, callback: AsyncCallback<Contact>): void;
35261847f8eSopenharmony_ci
35361847f8eSopenharmony_ci  /**
35461847f8eSopenharmony_ci   * Queries a specified contact of specified attributes.
35561847f8eSopenharmony_ci   *
35661847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
35761847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact.
35861847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
35961847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
36061847f8eSopenharmony_ci   * @param { AsyncCallback<Contact> } callback - Returns the specified contact.
36161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
36261847f8eSopenharmony_ci   * @since 7
36361847f8eSopenharmony_ci   * @deprecated since 10
36461847f8eSopenharmony_ci   * @useinstead contact.queryContact#queryContact
36561847f8eSopenharmony_ci   */
36661847f8eSopenharmony_ci  function queryContact(key: string, attrs: ContactAttributes, callback: AsyncCallback<Contact>): void;
36761847f8eSopenharmony_ci
36861847f8eSopenharmony_ci  /**
36961847f8eSopenharmony_ci   * Queries a specified contact of specified attributes.
37061847f8eSopenharmony_ci   *
37161847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
37261847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
37361847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact.
37461847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
37561847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
37661847f8eSopenharmony_ci   * @param { AsyncCallback<Contact> } callback - Returns the specified contact.
37761847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
37861847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
37961847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
38061847f8eSopenharmony_ci   * @since 10
38161847f8eSopenharmony_ci   */
38261847f8eSopenharmony_ci  function queryContact(context: Context, key: string, attrs: ContactAttributes, callback: AsyncCallback<Contact>): void;
38361847f8eSopenharmony_ci
38461847f8eSopenharmony_ci  /**
38561847f8eSopenharmony_ci   * Queries a specified contact of specified attributes.
38661847f8eSopenharmony_ci   *
38761847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
38861847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact.
38961847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
39061847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
39161847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
39261847f8eSopenharmony_ci   * @param { AsyncCallback<Contact> } callback - Returns the specified contact.
39361847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
39461847f8eSopenharmony_ci   * @since 7
39561847f8eSopenharmony_ci   * @deprecated since 10
39661847f8eSopenharmony_ci   * @useinstead contact.queryContact#queryContact
39761847f8eSopenharmony_ci   */
39861847f8eSopenharmony_ci  function queryContact(key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Contact>): void;
39961847f8eSopenharmony_ci
40061847f8eSopenharmony_ci  /**
40161847f8eSopenharmony_ci   * Queries a specified contact of specified attributes.
40261847f8eSopenharmony_ci   *
40361847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
40461847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
40561847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact.
40661847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
40761847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
40861847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
40961847f8eSopenharmony_ci   * @param { AsyncCallback<Contact> } callback - Returns the specified contact.
41061847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
41161847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
41261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
41361847f8eSopenharmony_ci   * @since 10
41461847f8eSopenharmony_ci   */
41561847f8eSopenharmony_ci  function queryContact(context: Context, key: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Contact>): void;
41661847f8eSopenharmony_ci
41761847f8eSopenharmony_ci  /**
41861847f8eSopenharmony_ci   * Queries a specified contact of specified attributes.
41961847f8eSopenharmony_ci   *
42061847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
42161847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact.
42261847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
42361847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
42461847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
42561847f8eSopenharmony_ci   * @returns { Promise<Contact> } Returns the specified contact.
42661847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
42761847f8eSopenharmony_ci   * @since 7
42861847f8eSopenharmony_ci   * @deprecated since 10
42961847f8eSopenharmony_ci   * @useinstead contact.queryContact#queryContact
43061847f8eSopenharmony_ci   */
43161847f8eSopenharmony_ci  function queryContact(key: string, holder?: Holder, attrs?: ContactAttributes): Promise<Contact>;
43261847f8eSopenharmony_ci
43361847f8eSopenharmony_ci  /**
43461847f8eSopenharmony_ci   * Queries a specified contact of specified attributes.
43561847f8eSopenharmony_ci   *
43661847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
43761847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
43861847f8eSopenharmony_ci   * @param { string } key - Indicates the unique query key of a contact.
43961847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
44061847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
44161847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
44261847f8eSopenharmony_ci   * @returns { Promise<Contact> } Returns the specified contact.
44361847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
44461847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
44561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
44661847f8eSopenharmony_ci   * @since 10
44761847f8eSopenharmony_ci   */
44861847f8eSopenharmony_ci  function queryContact(context: Context, key: string, holder?: Holder, attrs?: ContactAttributes): Promise<Contact>;
44961847f8eSopenharmony_ci
45061847f8eSopenharmony_ci  /**
45161847f8eSopenharmony_ci   * Queries contacts with query conditions.
45261847f8eSopenharmony_ci   *
45361847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
45461847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
45561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
45661847f8eSopenharmony_ci   * @since 7
45761847f8eSopenharmony_ci   * @deprecated since 10
45861847f8eSopenharmony_ci   * @useinstead contact.queryContacts#queryContacts
45961847f8eSopenharmony_ci   */
46061847f8eSopenharmony_ci  function queryContacts(callback: AsyncCallback<Array<Contact>>): void;
46161847f8eSopenharmony_ci
46261847f8eSopenharmony_ci  /**
46361847f8eSopenharmony_ci   * Queries contacts with query conditions.
46461847f8eSopenharmony_ci   *
46561847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
46661847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
46761847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
46861847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
46961847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
47061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
47161847f8eSopenharmony_ci   * @since 10
47261847f8eSopenharmony_ci   */
47361847f8eSopenharmony_ci  function queryContacts(context: Context, callback: AsyncCallback<Array<Contact>>): void;
47461847f8eSopenharmony_ci
47561847f8eSopenharmony_ci  /**
47661847f8eSopenharmony_ci   * Queries contacts with query conditions.
47761847f8eSopenharmony_ci   *
47861847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
47961847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
48061847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
48161847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
48261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
48361847f8eSopenharmony_ci   * @since 7
48461847f8eSopenharmony_ci   * @deprecated since 10
48561847f8eSopenharmony_ci   * @useinstead contact.queryContacts#queryContacts
48661847f8eSopenharmony_ci   */
48761847f8eSopenharmony_ci  function queryContacts(holder: Holder, callback: AsyncCallback<Array<Contact>>): void;
48861847f8eSopenharmony_ci
48961847f8eSopenharmony_ci  /**
49061847f8eSopenharmony_ci   * Queries contacts with query conditions.
49161847f8eSopenharmony_ci   *
49261847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
49361847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
49461847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
49561847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
49661847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
49761847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
49861847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
49961847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
50061847f8eSopenharmony_ci   * @since 10
50161847f8eSopenharmony_ci   */
50261847f8eSopenharmony_ci  function queryContacts(context: Context, holder: Holder, callback: AsyncCallback<Array<Contact>>): void;
50361847f8eSopenharmony_ci
50461847f8eSopenharmony_ci  /**
50561847f8eSopenharmony_ci   * Queries contacts with query conditions.
50661847f8eSopenharmony_ci   *
50761847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
50861847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
50961847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
51061847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
51161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
51261847f8eSopenharmony_ci   * @since 7
51361847f8eSopenharmony_ci   * @deprecated since 10
51461847f8eSopenharmony_ci   * @useinstead contact.queryContacts#queryContacts
51561847f8eSopenharmony_ci   */
51661847f8eSopenharmony_ci  function queryContacts(attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void;
51761847f8eSopenharmony_ci
51861847f8eSopenharmony_ci  /**
51961847f8eSopenharmony_ci   * Queries contacts with query conditions.
52061847f8eSopenharmony_ci   *
52161847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
52261847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
52361847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
52461847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
52561847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
52661847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
52761847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
52861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
52961847f8eSopenharmony_ci   * @since 10
53061847f8eSopenharmony_ci   */
53161847f8eSopenharmony_ci  function queryContacts(context: Context, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void;
53261847f8eSopenharmony_ci
53361847f8eSopenharmony_ci  /**
53461847f8eSopenharmony_ci   * Queries contacts with query conditions.
53561847f8eSopenharmony_ci   *
53661847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
53761847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
53861847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
53961847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
54061847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
54161847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
54261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
54361847f8eSopenharmony_ci   * @since 7
54461847f8eSopenharmony_ci   * @deprecated since 10
54561847f8eSopenharmony_ci   * @useinstead contact.queryContacts#queryContacts
54661847f8eSopenharmony_ci   */
54761847f8eSopenharmony_ci  function queryContacts(holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void;
54861847f8eSopenharmony_ci
54961847f8eSopenharmony_ci  /**
55061847f8eSopenharmony_ci   * Queries contacts with query conditions.
55161847f8eSopenharmony_ci   *
55261847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
55361847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
55461847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
55561847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
55661847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
55761847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
55861847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
55961847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
56061847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
56161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
56261847f8eSopenharmony_ci   * @since 10
56361847f8eSopenharmony_ci   */
56461847f8eSopenharmony_ci  function queryContacts(context: Context, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void;
56561847f8eSopenharmony_ci
56661847f8eSopenharmony_ci  /**
56761847f8eSopenharmony_ci   * Queries contacts with query conditions.
56861847f8eSopenharmony_ci   *
56961847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
57061847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
57161847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
57261847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
57361847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
57461847f8eSopenharmony_ci   * @returns { Promise<Array<Contact>> } Returns the {@code Contact} list object.
57561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
57661847f8eSopenharmony_ci   * @since 7
57761847f8eSopenharmony_ci   * @deprecated since 10
57861847f8eSopenharmony_ci   * @useinstead contact.queryContacts#queryContacts
57961847f8eSopenharmony_ci   */
58061847f8eSopenharmony_ci  function queryContacts(holder?: Holder, attrs?: ContactAttributes): Promise<Array<Contact>>;
58161847f8eSopenharmony_ci
58261847f8eSopenharmony_ci  /**
58361847f8eSopenharmony_ci   * Queries contacts with query conditions.
58461847f8eSopenharmony_ci   *
58561847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
58661847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
58761847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
58861847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
58961847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
59061847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
59161847f8eSopenharmony_ci   * @returns { Promise<Array<Contact>> } Returns the {@code Contact} list object.
59261847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
59361847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
59461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
59561847f8eSopenharmony_ci   * @since 10
59661847f8eSopenharmony_ci   */
59761847f8eSopenharmony_ci  function queryContacts(context: Context, holder?: Holder, attrs?: ContactAttributes): Promise<Array<Contact>>;
59861847f8eSopenharmony_ci
59961847f8eSopenharmony_ci  /**
60061847f8eSopenharmony_ci   * Queries contacts by a specified email address.
60161847f8eSopenharmony_ci   *
60261847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
60361847f8eSopenharmony_ci   * @param { string } email - Indicates the email address.
60461847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns a {@code Contact} list object.
60561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
60661847f8eSopenharmony_ci   * @since 7
60761847f8eSopenharmony_ci   * @deprecated since 10
60861847f8eSopenharmony_ci   * @useinstead contact.queryContactsByEmail#queryContactsByEmail
60961847f8eSopenharmony_ci   */
61061847f8eSopenharmony_ci  function queryContactsByEmail(email: string, callback: AsyncCallback<Array<Contact>>): void;
61161847f8eSopenharmony_ci
61261847f8eSopenharmony_ci  /**
61361847f8eSopenharmony_ci   * Queries contacts by a specified email address.
61461847f8eSopenharmony_ci   *
61561847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
61661847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
61761847f8eSopenharmony_ci   * @param { string } email - Indicates the email address.
61861847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns a {@code Contact} list object.
61961847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
62061847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
62161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
62261847f8eSopenharmony_ci   * @since 10
62361847f8eSopenharmony_ci   */
62461847f8eSopenharmony_ci  function queryContactsByEmail(context: Context, email: string, callback: AsyncCallback<Array<Contact>>): void;
62561847f8eSopenharmony_ci
62661847f8eSopenharmony_ci  /**
62761847f8eSopenharmony_ci   * Queries contacts by a specified email address and contact holder.
62861847f8eSopenharmony_ci   *
62961847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
63061847f8eSopenharmony_ci   * @param { string } email - Indicates the email address.
63161847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
63261847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
63361847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns a {@code Contact} list object.
63461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
63561847f8eSopenharmony_ci   * @since 7
63661847f8eSopenharmony_ci   * @deprecated since 10
63761847f8eSopenharmony_ci   * @useinstead contact.queryContactsByEmail#queryContactsByEmail
63861847f8eSopenharmony_ci   */
63961847f8eSopenharmony_ci  function queryContactsByEmail(email: string, holder: Holder, callback: AsyncCallback<Array<Contact>>): void;
64061847f8eSopenharmony_ci
64161847f8eSopenharmony_ci  /**
64261847f8eSopenharmony_ci   * Queries contacts by a specified email address and contact holder.
64361847f8eSopenharmony_ci   *
64461847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
64561847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
64661847f8eSopenharmony_ci   * @param { string } email - Indicates the email address.
64761847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
64861847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
64961847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns a {@code Contact} list object.
65061847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
65161847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
65261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
65361847f8eSopenharmony_ci   * @since 10
65461847f8eSopenharmony_ci   */
65561847f8eSopenharmony_ci  function queryContactsByEmail(context: Context, email: string, holder: Holder,
65661847f8eSopenharmony_ci    callback: AsyncCallback<Array<Contact>>): void;
65761847f8eSopenharmony_ci
65861847f8eSopenharmony_ci  /**
65961847f8eSopenharmony_ci   * Queries contacts by a specified email address and contact attributes.
66061847f8eSopenharmony_ci   *
66161847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
66261847f8eSopenharmony_ci   * @param { string } email - Indicates the email address.
66361847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
66461847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
66561847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns a {@code Contact} list object.
66661847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
66761847f8eSopenharmony_ci   * @since 7
66861847f8eSopenharmony_ci   * @deprecated since 10
66961847f8eSopenharmony_ci   * @useinstead contact.queryContactsByEmail#queryContactsByEmail
67061847f8eSopenharmony_ci   */
67161847f8eSopenharmony_ci  function queryContactsByEmail(email: string, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void;
67261847f8eSopenharmony_ci
67361847f8eSopenharmony_ci  /**
67461847f8eSopenharmony_ci   * Queries contacts by a specified email address and contact attributes.
67561847f8eSopenharmony_ci   *
67661847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
67761847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
67861847f8eSopenharmony_ci   * @param { string } email - Indicates the email address.
67961847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
68061847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
68161847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns a {@code Contact} list object.
68261847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
68361847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
68461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
68561847f8eSopenharmony_ci   * @since 10
68661847f8eSopenharmony_ci   */
68761847f8eSopenharmony_ci  function queryContactsByEmail(context: Context, email: string, attrs: ContactAttributes,
68861847f8eSopenharmony_ci    callback: AsyncCallback<Array<Contact>>): void;
68961847f8eSopenharmony_ci
69061847f8eSopenharmony_ci  /**
69161847f8eSopenharmony_ci   * Queries contacts by a specified email address, contact holder, and contact attributes.
69261847f8eSopenharmony_ci   *
69361847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
69461847f8eSopenharmony_ci   * @param { string } email - Indicates the email address.
69561847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
69661847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
69761847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
69861847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
69961847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns a {@code Contact} list object.
70061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
70161847f8eSopenharmony_ci   * @since 7
70261847f8eSopenharmony_ci   * @deprecated since 10
70361847f8eSopenharmony_ci   * @useinstead contact.queryContactsByEmail#queryContactsByEmail
70461847f8eSopenharmony_ci   */
70561847f8eSopenharmony_ci  function queryContactsByEmail(email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void;
70661847f8eSopenharmony_ci
70761847f8eSopenharmony_ci  /**
70861847f8eSopenharmony_ci   * Queries contacts by a specified email address, contact holder, and contact attributes.
70961847f8eSopenharmony_ci   *
71061847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
71161847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
71261847f8eSopenharmony_ci   * @param { string } email - Indicates the email address.
71361847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
71461847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
71561847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
71661847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
71761847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns a {@code Contact} list object.
71861847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
71961847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
72061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
72161847f8eSopenharmony_ci   * @since 10
72261847f8eSopenharmony_ci   */
72361847f8eSopenharmony_ci  function queryContactsByEmail(context: Context, email: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void;
72461847f8eSopenharmony_ci
72561847f8eSopenharmony_ci  /**
72661847f8eSopenharmony_ci   * Queries contacts by a specified email address, contact holder, and contact attributes.
72761847f8eSopenharmony_ci   *
72861847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
72961847f8eSopenharmony_ci   * @param { string } email - Indicates the email address.
73061847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
73161847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
73261847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
73361847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
73461847f8eSopenharmony_ci   * @returns { Promise<Array<Contact>> } Returns a {@code Contact} list object.
73561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
73661847f8eSopenharmony_ci   * @since 7
73761847f8eSopenharmony_ci   * @deprecated since 10
73861847f8eSopenharmony_ci   * @useinstead contact.queryContactsByEmail#queryContactsByEmail
73961847f8eSopenharmony_ci   */
74061847f8eSopenharmony_ci  function queryContactsByEmail(email: string, holder?: Holder, attrs?: ContactAttributes): Promise<Array<Contact>>;
74161847f8eSopenharmony_ci
74261847f8eSopenharmony_ci  /**
74361847f8eSopenharmony_ci   * Queries contacts by a specified email address, contact holder, and contact attributes.
74461847f8eSopenharmony_ci   *
74561847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
74661847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
74761847f8eSopenharmony_ci   * @param { string } email - Indicates the email address.
74861847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
74961847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
75061847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attributes.
75161847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
75261847f8eSopenharmony_ci   * @returns { Promise<Array<Contact>> } Returns a {@code Contact} list object.
75361847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
75461847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
75561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
75661847f8eSopenharmony_ci   * @since 10
75761847f8eSopenharmony_ci   */
75861847f8eSopenharmony_ci  function queryContactsByEmail(context: Context, email: string, holder?: Holder, attrs?: ContactAttributes): Promise<Array<Contact>>;
75961847f8eSopenharmony_ci
76061847f8eSopenharmony_ci  /**
76161847f8eSopenharmony_ci   * Queries contacts by a phone number.
76261847f8eSopenharmony_ci   *
76361847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
76461847f8eSopenharmony_ci   * @param { string } phoneNumber - Indicates the phone number.
76561847f8eSopenharmony_ci   * Only full match is supported, and wildcards are not supported.
76661847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
76761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
76861847f8eSopenharmony_ci   * @since 7
76961847f8eSopenharmony_ci   * @deprecated since 10
77061847f8eSopenharmony_ci   * @useinstead contact.queryContactsByPhoneNumber#queryContactsByPhoneNumber
77161847f8eSopenharmony_ci   */
77261847f8eSopenharmony_ci  function queryContactsByPhoneNumber(phoneNumber: string, callback: AsyncCallback<Array<Contact>>): void;
77361847f8eSopenharmony_ci
77461847f8eSopenharmony_ci  /**
77561847f8eSopenharmony_ci   * Queries contacts by a phone number.
77661847f8eSopenharmony_ci   *
77761847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
77861847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
77961847f8eSopenharmony_ci   * @param { string } phoneNumber - Indicates the phone number.
78061847f8eSopenharmony_ci   * Only full match is supported, and wildcards are not supported.
78161847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
78261847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
78361847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
78461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
78561847f8eSopenharmony_ci   * @since 10
78661847f8eSopenharmony_ci   */
78761847f8eSopenharmony_ci  function queryContactsByPhoneNumber(context: Context, phoneNumber: string, callback: AsyncCallback<Array<Contact>>): void;
78861847f8eSopenharmony_ci
78961847f8eSopenharmony_ci  /**
79061847f8eSopenharmony_ci   * Queries contacts by a phone number and contact holder.
79161847f8eSopenharmony_ci   *
79261847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
79361847f8eSopenharmony_ci   * @param { string } phoneNumber - Indicates the phone number.
79461847f8eSopenharmony_ci   * Only full match is supported, and wildcards are not supported.
79561847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
79661847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
79761847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
79861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
79961847f8eSopenharmony_ci   * @since 7
80061847f8eSopenharmony_ci   * @deprecated since 10
80161847f8eSopenharmony_ci   * @useinstead contact.queryContactsByPhoneNumber#queryContactsByPhoneNumber
80261847f8eSopenharmony_ci   */
80361847f8eSopenharmony_ci  function queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, callback: AsyncCallback<Array<Contact>>): void;
80461847f8eSopenharmony_ci
80561847f8eSopenharmony_ci  /**
80661847f8eSopenharmony_ci   * Queries contacts by a phone number and contact holder.
80761847f8eSopenharmony_ci   *
80861847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
80961847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
81061847f8eSopenharmony_ci   * @param { string } phoneNumber - Indicates the phone number.
81161847f8eSopenharmony_ci   * Only full match is supported, and wildcards are not supported.
81261847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
81361847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
81461847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
81561847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
81661847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
81761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
81861847f8eSopenharmony_ci   * @since 10
81961847f8eSopenharmony_ci   */
82061847f8eSopenharmony_ci  function queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holder, callback: AsyncCallback<Array<Contact>>): void;
82161847f8eSopenharmony_ci
82261847f8eSopenharmony_ci  /**
82361847f8eSopenharmony_ci   * Queries contacts by a phone number and contact attribute.
82461847f8eSopenharmony_ci   *
82561847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
82661847f8eSopenharmony_ci   * @param { string } phoneNumber - Indicates the phone number.
82761847f8eSopenharmony_ci   * Only full match is supported, and wildcards are not supported.
82861847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
82961847f8eSopenharmony_ci   * If this parameter is null, all attributes will be used for matching.
83061847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
83161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
83261847f8eSopenharmony_ci   * @since 7
83361847f8eSopenharmony_ci   * @deprecated since 10
83461847f8eSopenharmony_ci   * @useinstead contact.queryContactsByPhoneNumber#queryContactsByPhoneNumber
83561847f8eSopenharmony_ci   */
83661847f8eSopenharmony_ci  function queryContactsByPhoneNumber(phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void;
83761847f8eSopenharmony_ci
83861847f8eSopenharmony_ci  /**
83961847f8eSopenharmony_ci   * Queries contacts by a phone number and contact attribute.
84061847f8eSopenharmony_ci   *
84161847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
84261847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
84361847f8eSopenharmony_ci   * @param { string } phoneNumber - Indicates the phone number.
84461847f8eSopenharmony_ci   * Only full match is supported, and wildcards are not supported.
84561847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
84661847f8eSopenharmony_ci   * If this parameter is null, all attributes will be used for matching.
84761847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
84861847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
84961847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
85061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
85161847f8eSopenharmony_ci   * @since 10
85261847f8eSopenharmony_ci   */
85361847f8eSopenharmony_ci  function queryContactsByPhoneNumber(context: Context, phoneNumber: string, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void;
85461847f8eSopenharmony_ci
85561847f8eSopenharmony_ci  /**
85661847f8eSopenharmony_ci   * Queries contacts by a phone number, contact holder and contact attribute.
85761847f8eSopenharmony_ci   *
85861847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
85961847f8eSopenharmony_ci   * @param { string } phoneNumber - Indicates the phone number.
86061847f8eSopenharmony_ci   * Only full match is supported, and wildcards are not supported.
86161847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
86261847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
86361847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
86461847f8eSopenharmony_ci   * If this parameter is null, all attributes will be used for matching.
86561847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
86661847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
86761847f8eSopenharmony_ci   * @since 7
86861847f8eSopenharmony_ci   * @deprecated since 10
86961847f8eSopenharmony_ci   * @useinstead contact.queryContactsByPhoneNumber#queryContactsByPhoneNumber
87061847f8eSopenharmony_ci   */
87161847f8eSopenharmony_ci  function queryContactsByPhoneNumber(phoneNumber: string, holder: Holder, attrs: ContactAttributes, callback: AsyncCallback<Array<Contact>>): void;
87261847f8eSopenharmony_ci
87361847f8eSopenharmony_ci  /**
87461847f8eSopenharmony_ci   * Queries contacts by a phone number, contact holder and contact attribute.
87561847f8eSopenharmony_ci   *
87661847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
87761847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
87861847f8eSopenharmony_ci   * @param { string } phoneNumber - Indicates the phone number.
87961847f8eSopenharmony_ci   * Only full match is supported, and wildcards are not supported.
88061847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
88161847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
88261847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
88361847f8eSopenharmony_ci   * If this parameter is null, all attributes will be used for matching.
88461847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Contact>> } callback - Returns the {@code Contact} list object.
88561847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
88661847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
88761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
88861847f8eSopenharmony_ci   * @since 10
88961847f8eSopenharmony_ci   */
89061847f8eSopenharmony_ci  function queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder: Holder, attrs: ContactAttributes,
89161847f8eSopenharmony_ci    callback: AsyncCallback<Array<Contact>>): void;
89261847f8eSopenharmony_ci
89361847f8eSopenharmony_ci  /**
89461847f8eSopenharmony_ci   * Queries contacts by a phone number, contact holder and contact attribute.
89561847f8eSopenharmony_ci   *
89661847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
89761847f8eSopenharmony_ci   * @param { string } phoneNumber - Indicates the phone number.
89861847f8eSopenharmony_ci   * Only full match is supported, and wildcards are not supported.
89961847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
90061847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
90161847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
90261847f8eSopenharmony_ci   * If this parameter is null, all attributes will be used for matching.
90361847f8eSopenharmony_ci   * @returns { Promise<Array<Contact>> } Returns the {@code Contact} list object.
90461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
90561847f8eSopenharmony_ci   * @since 7
90661847f8eSopenharmony_ci   * @deprecated since 10
90761847f8eSopenharmony_ci   * @useinstead contact.queryContactsByPhoneNumber#queryContactsByPhoneNumber
90861847f8eSopenharmony_ci   */
90961847f8eSopenharmony_ci  function queryContactsByPhoneNumber(phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise<Array<Contact>>;
91061847f8eSopenharmony_ci
91161847f8eSopenharmony_ci  /**
91261847f8eSopenharmony_ci   * Queries contacts by a phone number, contact holder and contact attribute.
91361847f8eSopenharmony_ci   *
91461847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
91561847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
91661847f8eSopenharmony_ci   * @param { string } phoneNumber - Indicates the phone number.
91761847f8eSopenharmony_ci   * Only full match is supported, and wildcards are not supported.
91861847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
91961847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
92061847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
92161847f8eSopenharmony_ci   * If this parameter is null, all attributes will be used for matching.
92261847f8eSopenharmony_ci   * @returns { Promise<Array<Contact>> } Returns the {@code Contact} list object.
92361847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
92461847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
92561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
92661847f8eSopenharmony_ci   * @since 10
92761847f8eSopenharmony_ci   */
92861847f8eSopenharmony_ci  function queryContactsByPhoneNumber(context: Context, phoneNumber: string, holder?: Holder, attrs?: ContactAttributes): Promise<Array<Contact>>;
92961847f8eSopenharmony_ci
93061847f8eSopenharmony_ci  /**
93161847f8eSopenharmony_ci   * Queries contact groups.
93261847f8eSopenharmony_ci   *
93361847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
93461847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Group>> } callback - Returns the contact group list object.
93561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
93661847f8eSopenharmony_ci   * @since 7
93761847f8eSopenharmony_ci   * @deprecated since 10
93861847f8eSopenharmony_ci   * @useinstead contact.queryGroups#queryGroups
93961847f8eSopenharmony_ci   */
94061847f8eSopenharmony_ci  function queryGroups(callback: AsyncCallback<Array<Group>>): void;
94161847f8eSopenharmony_ci
94261847f8eSopenharmony_ci  /**
94361847f8eSopenharmony_ci   * Queries contact groups.
94461847f8eSopenharmony_ci   *
94561847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
94661847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
94761847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Group>> } callback - Returns the contact group list object.
94861847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
94961847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
95061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
95161847f8eSopenharmony_ci   * @since 10
95261847f8eSopenharmony_ci   */
95361847f8eSopenharmony_ci  function queryGroups(context: Context, callback: AsyncCallback<Array<Group>>): void;
95461847f8eSopenharmony_ci
95561847f8eSopenharmony_ci  /**
95661847f8eSopenharmony_ci   * Queries contact groups by contact holder.
95761847f8eSopenharmony_ci   *
95861847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
95961847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
96061847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
96161847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Group>> } callback - Returns the contact group list object.
96261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
96361847f8eSopenharmony_ci   * @since 7
96461847f8eSopenharmony_ci   * @deprecated since 10
96561847f8eSopenharmony_ci   * @useinstead contact.queryGroups#queryGroups
96661847f8eSopenharmony_ci   */
96761847f8eSopenharmony_ci  function queryGroups(holder: Holder, callback: AsyncCallback<Array<Group>>): void;
96861847f8eSopenharmony_ci
96961847f8eSopenharmony_ci  /**
97061847f8eSopenharmony_ci   * Queries contact groups by contact holder.
97161847f8eSopenharmony_ci   *
97261847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
97361847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
97461847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
97561847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
97661847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Group>> } callback - Returns the contact group list object.
97761847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
97861847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
97961847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
98061847f8eSopenharmony_ci   * @since 10
98161847f8eSopenharmony_ci   */
98261847f8eSopenharmony_ci  function queryGroups(context: Context, holder: Holder, callback: AsyncCallback<Array<Group>>): void;
98361847f8eSopenharmony_ci
98461847f8eSopenharmony_ci  /**
98561847f8eSopenharmony_ci   * Queries contact groups by contact holder.
98661847f8eSopenharmony_ci   *
98761847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
98861847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
98961847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
99061847f8eSopenharmony_ci   * @returns { Promise<Array<Group>> } Returns the contact group list object.
99161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
99261847f8eSopenharmony_ci   * @since 7
99361847f8eSopenharmony_ci   * @deprecated since 10
99461847f8eSopenharmony_ci   * @useinstead contact.queryGroups#queryGroups
99561847f8eSopenharmony_ci   */
99661847f8eSopenharmony_ci  function queryGroups(holder?: Holder): Promise<Array<Group>>;
99761847f8eSopenharmony_ci
99861847f8eSopenharmony_ci  /**
99961847f8eSopenharmony_ci   * Queries contact groups by contact holder.
100061847f8eSopenharmony_ci   *
100161847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
100261847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
100361847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
100461847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
100561847f8eSopenharmony_ci   * @returns { Promise<Array<Group>> } Returns the contact group list object.
100661847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
100761847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
100861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
100961847f8eSopenharmony_ci   * @since 10
101061847f8eSopenharmony_ci   */
101161847f8eSopenharmony_ci  function queryGroups(context: Context, holder?: Holder): Promise<Array<Group>>;
101261847f8eSopenharmony_ci
101361847f8eSopenharmony_ci  /**
101461847f8eSopenharmony_ci   * Queries contact holders.
101561847f8eSopenharmony_ci   *
101661847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
101761847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Holder>> } callback - Returns the {@code Holder} list object.
101861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
101961847f8eSopenharmony_ci   * @since 7
102061847f8eSopenharmony_ci   * @deprecated since 10
102161847f8eSopenharmony_ci   * @useinstead contact.queryHolders#queryHolders
102261847f8eSopenharmony_ci   */
102361847f8eSopenharmony_ci  function queryHolders(callback: AsyncCallback<Array<Holder>>): void;
102461847f8eSopenharmony_ci
102561847f8eSopenharmony_ci  /**
102661847f8eSopenharmony_ci   * Queries contact holders.
102761847f8eSopenharmony_ci   *
102861847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
102961847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
103061847f8eSopenharmony_ci   * @param { AsyncCallback<Array<Holder>> } callback - Returns the {@code Holder} list object.
103161847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
103261847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
103361847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
103461847f8eSopenharmony_ci   * @since 10
103561847f8eSopenharmony_ci   */
103661847f8eSopenharmony_ci  function queryHolders(context: Context, callback: AsyncCallback<Array<Holder>>): void;
103761847f8eSopenharmony_ci
103861847f8eSopenharmony_ci  /**
103961847f8eSopenharmony_ci   * Queries contact holders.
104061847f8eSopenharmony_ci   *
104161847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
104261847f8eSopenharmony_ci   * @returns { Promise<Array<Holder>> } Returns the {@code Holder} list object.
104361847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
104461847f8eSopenharmony_ci   * @since 7
104561847f8eSopenharmony_ci   * @deprecated since 10
104661847f8eSopenharmony_ci   * @useinstead contact.queryHolders#queryHolders
104761847f8eSopenharmony_ci   */
104861847f8eSopenharmony_ci  function queryHolders(): Promise<Array<Holder>>;
104961847f8eSopenharmony_ci
105061847f8eSopenharmony_ci  /**
105161847f8eSopenharmony_ci   * Queries contact holders.
105261847f8eSopenharmony_ci   *
105361847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
105461847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
105561847f8eSopenharmony_ci   * @returns { Promise<Array<Holder>> } Returns the {@code Holder} list object.
105661847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
105761847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
105861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
105961847f8eSopenharmony_ci   * @since 10
106061847f8eSopenharmony_ci   */
106161847f8eSopenharmony_ci  function queryHolders(context: Context): Promise<Array<Holder>>;
106261847f8eSopenharmony_ci
106361847f8eSopenharmony_ci  /**
106461847f8eSopenharmony_ci   * Obtains the query key of a contact based on a specified ID.
106561847f8eSopenharmony_ci   *
106661847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
106761847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
106861847f8eSopenharmony_ci   * @param { AsyncCallback<string> } callback - Returns the query key of the contact.
106961847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
107061847f8eSopenharmony_ci   * @since 7
107161847f8eSopenharmony_ci   * @deprecated since 10
107261847f8eSopenharmony_ci   * @useinstead contact.queryKey#queryKey
107361847f8eSopenharmony_ci   */
107461847f8eSopenharmony_ci  function queryKey(id: number, callback: AsyncCallback<string>): void;
107561847f8eSopenharmony_ci
107661847f8eSopenharmony_ci  /**
107761847f8eSopenharmony_ci   * Obtains the query key of a contact based on a specified ID.
107861847f8eSopenharmony_ci   *
107961847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
108061847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
108161847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
108261847f8eSopenharmony_ci   * @param { AsyncCallback<string> } callback - Returns the query key of the contact.
108361847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
108461847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified. 2.Parameter verification failed.
108561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
108661847f8eSopenharmony_ci   * @since 10
108761847f8eSopenharmony_ci   */
108861847f8eSopenharmony_ci  function queryKey(context: Context, id: number, callback: AsyncCallback<string>): void;
108961847f8eSopenharmony_ci
109061847f8eSopenharmony_ci  /**
109161847f8eSopenharmony_ci   * Obtains the query key of a contact based on a specified ID and holder.
109261847f8eSopenharmony_ci   *
109361847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
109461847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
109561847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
109661847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
109761847f8eSopenharmony_ci   * @param { AsyncCallback<string> } callback - Returns the query key of the contact.
109861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
109961847f8eSopenharmony_ci   * @since 7
110061847f8eSopenharmony_ci   * @deprecated since 10
110161847f8eSopenharmony_ci   * @useinstead contact.queryKey#queryKey
110261847f8eSopenharmony_ci   */
110361847f8eSopenharmony_ci  function queryKey(id: number, holder: Holder, callback: AsyncCallback<string>): void;
110461847f8eSopenharmony_ci
110561847f8eSopenharmony_ci  /**
110661847f8eSopenharmony_ci   * Obtains the query key of a contact based on a specified ID and holder.
110761847f8eSopenharmony_ci   *
110861847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
110961847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
111061847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
111161847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
111261847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
111361847f8eSopenharmony_ci   * @param { AsyncCallback<string> } callback - Returns the query key of the contact.
111461847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
111561847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified. 2.Parameter verification failed.
111661847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
111761847f8eSopenharmony_ci   * @since 10
111861847f8eSopenharmony_ci   */
111961847f8eSopenharmony_ci  function queryKey(context: Context, id: number, holder: Holder, callback: AsyncCallback<string>): void;
112061847f8eSopenharmony_ci
112161847f8eSopenharmony_ci  /**
112261847f8eSopenharmony_ci   * Obtains the query key of a contact based on a specified ID and holder.
112361847f8eSopenharmony_ci   *
112461847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
112561847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
112661847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
112761847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
112861847f8eSopenharmony_ci   * @returns { Promise<string> } Returns the query key of the contact.
112961847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
113061847f8eSopenharmony_ci   * @since 7
113161847f8eSopenharmony_ci   * @deprecated since 10
113261847f8eSopenharmony_ci   * @useinstead contact.queryKey#queryKey
113361847f8eSopenharmony_ci   */
113461847f8eSopenharmony_ci  function queryKey(id: number, holder?: Holder): Promise<string>;
113561847f8eSopenharmony_ci
113661847f8eSopenharmony_ci  /**
113761847f8eSopenharmony_ci   * Obtains the query key of a contact based on a specified ID and holder.
113861847f8eSopenharmony_ci   *
113961847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
114061847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
114161847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
114261847f8eSopenharmony_ci   * @param { Holder } holder - Indicates the contact holder.
114361847f8eSopenharmony_ci   * If this parameter is null, the default holder is used for matching.
114461847f8eSopenharmony_ci   * @returns { Promise<string> } Returns the query key of the contact.
114561847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
114661847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified. 2.Parameter verification failed.
114761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
114861847f8eSopenharmony_ci   * @since 10
114961847f8eSopenharmony_ci   */
115061847f8eSopenharmony_ci  function queryKey(context: Context, id: number, holder?: Holder): Promise<string>;
115161847f8eSopenharmony_ci
115261847f8eSopenharmony_ci  /**
115361847f8eSopenharmony_ci   * Queries information about "my card".
115461847f8eSopenharmony_ci   *
115561847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
115661847f8eSopenharmony_ci   * @param { AsyncCallback<Contact> } callback - Returns information about "my card".
115761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
115861847f8eSopenharmony_ci   * @since 7
115961847f8eSopenharmony_ci   * @deprecated since 10
116061847f8eSopenharmony_ci   * @useinstead contact.queryMyCard#queryMyCard
116161847f8eSopenharmony_ci   */
116261847f8eSopenharmony_ci  function queryMyCard(callback: AsyncCallback<Contact>): void;
116361847f8eSopenharmony_ci
116461847f8eSopenharmony_ci  /**
116561847f8eSopenharmony_ci   * Queries information about "my card".
116661847f8eSopenharmony_ci   *
116761847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
116861847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
116961847f8eSopenharmony_ci   * @param { AsyncCallback<Contact> } callback - Returns information about "my card".
117061847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
117161847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
117261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
117361847f8eSopenharmony_ci   * @since 10
117461847f8eSopenharmony_ci   */
117561847f8eSopenharmony_ci  function queryMyCard(context: Context, callback: AsyncCallback<Contact>): void;
117661847f8eSopenharmony_ci
117761847f8eSopenharmony_ci  /**
117861847f8eSopenharmony_ci   * Queries information about "my card".
117961847f8eSopenharmony_ci   *
118061847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
118161847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
118261847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
118361847f8eSopenharmony_ci   * @param { AsyncCallback<Contact> } callback - Returns information about "my card".
118461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
118561847f8eSopenharmony_ci   * @since 7
118661847f8eSopenharmony_ci   * @deprecated since 10
118761847f8eSopenharmony_ci   * @useinstead contact.queryMyCard#queryMyCard
118861847f8eSopenharmony_ci   */
118961847f8eSopenharmony_ci  function queryMyCard(attrs: ContactAttributes, callback: AsyncCallback<Contact>): void;
119061847f8eSopenharmony_ci
119161847f8eSopenharmony_ci  /**
119261847f8eSopenharmony_ci   * Queries information about "my card".
119361847f8eSopenharmony_ci   *
119461847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
119561847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
119661847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
119761847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
119861847f8eSopenharmony_ci   * @param { AsyncCallback<Contact> } callback - Returns information about "my card".
119961847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
120061847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
120161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
120261847f8eSopenharmony_ci   * @since 10
120361847f8eSopenharmony_ci   */
120461847f8eSopenharmony_ci  function queryMyCard(context: Context, attrs: ContactAttributes, callback: AsyncCallback<Contact>): void;
120561847f8eSopenharmony_ci
120661847f8eSopenharmony_ci  /**
120761847f8eSopenharmony_ci   * Queries information about "my card".
120861847f8eSopenharmony_ci   *
120961847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
121061847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
121161847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
121261847f8eSopenharmony_ci   * @returns { Promise<Contact> } Returns information about "my card".
121361847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
121461847f8eSopenharmony_ci   * @since 7
121561847f8eSopenharmony_ci   * @deprecated since 10
121661847f8eSopenharmony_ci   * @useinstead contact.queryMyCard#queryMyCard
121761847f8eSopenharmony_ci   */
121861847f8eSopenharmony_ci  function queryMyCard(attrs?: ContactAttributes): Promise<Contact>;
121961847f8eSopenharmony_ci
122061847f8eSopenharmony_ci  /**
122161847f8eSopenharmony_ci   * Queries information about "my card".
122261847f8eSopenharmony_ci   *
122361847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
122461847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
122561847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
122661847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
122761847f8eSopenharmony_ci   * @returns { Promise<Contact> } Returns information about "my card".
122861847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
122961847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
123061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
123161847f8eSopenharmony_ci   * @since 10
123261847f8eSopenharmony_ci   */
123361847f8eSopenharmony_ci  function queryMyCard(context: Context, attrs?: ContactAttributes): Promise<Contact>;
123461847f8eSopenharmony_ci
123561847f8eSopenharmony_ci  /**
123661847f8eSopenharmony_ci   * Updates specified attributes of a contact.
123761847f8eSopenharmony_ci   *
123861847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
123961847f8eSopenharmony_ci   * @param { Contact } contact - Indicates the contact whose information is to update.
124061847f8eSopenharmony_ci   * @param { AsyncCallback<void> } callback - The callback of updateContact.
124161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
124261847f8eSopenharmony_ci   * @since 7
124361847f8eSopenharmony_ci   * @deprecated since 10
124461847f8eSopenharmony_ci   * @useinstead contact.updateContact#updateContact
124561847f8eSopenharmony_ci   */
124661847f8eSopenharmony_ci  function updateContact(contact: Contact, callback: AsyncCallback<void>): void;
124761847f8eSopenharmony_ci
124861847f8eSopenharmony_ci  /**
124961847f8eSopenharmony_ci   * Updates specified attributes of a contact.
125061847f8eSopenharmony_ci   *
125161847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
125261847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
125361847f8eSopenharmony_ci   * @param { Contact } contact - Indicates the contact whose information is to update.
125461847f8eSopenharmony_ci   * @param { AsyncCallback<void> } callback - The callback of updateContact.
125561847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
125661847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
125761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
125861847f8eSopenharmony_ci   * @since 10
125961847f8eSopenharmony_ci   */
126061847f8eSopenharmony_ci  function updateContact(context: Context, contact: Contact, callback: AsyncCallback<void>): void;
126161847f8eSopenharmony_ci
126261847f8eSopenharmony_ci  /**
126361847f8eSopenharmony_ci   * Updates specified attributes of a contact.
126461847f8eSopenharmony_ci   *
126561847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
126661847f8eSopenharmony_ci   * @param { Contact } contact - Indicates the contact whose information is to update.
126761847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
126861847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
126961847f8eSopenharmony_ci   * @param { AsyncCallback<void> } callback - The callback of updateContact.
127061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
127161847f8eSopenharmony_ci   * @since 7
127261847f8eSopenharmony_ci   * @deprecated since 10
127361847f8eSopenharmony_ci   * @useinstead contact.updateContact#updateContact
127461847f8eSopenharmony_ci   */
127561847f8eSopenharmony_ci  function updateContact(contact: Contact, attrs: ContactAttributes, callback: AsyncCallback<void>): void;
127661847f8eSopenharmony_ci
127761847f8eSopenharmony_ci  /**
127861847f8eSopenharmony_ci   * Updates specified attributes of a contact.
127961847f8eSopenharmony_ci   *
128061847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
128161847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
128261847f8eSopenharmony_ci   * @param { Contact } contact - Indicates the contact whose information is to update.
128361847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
128461847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
128561847f8eSopenharmony_ci   * @param { AsyncCallback<void> } callback - The callback of updateContact.
128661847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
128761847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
128861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
128961847f8eSopenharmony_ci   * @since 10
129061847f8eSopenharmony_ci   */
129161847f8eSopenharmony_ci  function updateContact(context: Context, contact: Contact, attrs: ContactAttributes, callback: AsyncCallback<void>): void;
129261847f8eSopenharmony_ci
129361847f8eSopenharmony_ci  /**
129461847f8eSopenharmony_ci   * Updates specified attributes of a contact.
129561847f8eSopenharmony_ci   *
129661847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
129761847f8eSopenharmony_ci   * @param { Contact } contact - Indicates the contact whose information is to update.
129861847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
129961847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
130061847f8eSopenharmony_ci   * @returns { Promise<void> } The promise returned by the function.
130161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
130261847f8eSopenharmony_ci   * @since 7
130361847f8eSopenharmony_ci   * @deprecated since 10
130461847f8eSopenharmony_ci   * @useinstead contact.updateContact#updateContact
130561847f8eSopenharmony_ci   */
130661847f8eSopenharmony_ci  function updateContact(contact: Contact, attrs?: ContactAttributes): Promise<void>;
130761847f8eSopenharmony_ci
130861847f8eSopenharmony_ci  /**
130961847f8eSopenharmony_ci   * Updates specified attributes of a contact.
131061847f8eSopenharmony_ci   *
131161847f8eSopenharmony_ci   * @permission ohos.permission.WRITE_CONTACTS
131261847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
131361847f8eSopenharmony_ci   * @param { Contact } contact - Indicates the contact whose information is to update.
131461847f8eSopenharmony_ci   * @param { ContactAttributes } attrs - Indicates the contact attribute.
131561847f8eSopenharmony_ci   * If this parameter is null, all attributes are used for matching.
131661847f8eSopenharmony_ci   * @returns { Promise<void> } The promise returned by the function.
131761847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
131861847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: Mandatory parameters are left unspecified.
131961847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
132061847f8eSopenharmony_ci   * @since 10
132161847f8eSopenharmony_ci   */
132261847f8eSopenharmony_ci  function updateContact(context: Context, contact: Contact, attrs?: ContactAttributes): Promise<void>;
132361847f8eSopenharmony_ci
132461847f8eSopenharmony_ci  /**
132561847f8eSopenharmony_ci   * Checks whether the contact ID is in the local phone book.
132661847f8eSopenharmony_ci   *
132761847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
132861847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
132961847f8eSopenharmony_ci   * @param { AsyncCallback<boolean> } callback - The callback of isLocalContact.
133061847f8eSopenharmony_ci   * Returns {@code true} if the contact ID is in the local phone book; returns {@code false} otherwise.
133161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
133261847f8eSopenharmony_ci   * @since 7
133361847f8eSopenharmony_ci   * @deprecated since 10
133461847f8eSopenharmony_ci   * @useinstead contact.isLocalContact#isLocalContact
133561847f8eSopenharmony_ci   */
133661847f8eSopenharmony_ci  function isLocalContact(id: number, callback: AsyncCallback<boolean>): void;
133761847f8eSopenharmony_ci
133861847f8eSopenharmony_ci  /**
133961847f8eSopenharmony_ci   * Checks whether the contact ID is in the local phone book.
134061847f8eSopenharmony_ci   *
134161847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
134261847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
134361847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
134461847f8eSopenharmony_ci   * @param { AsyncCallback<boolean> } callback - The callback of isLocalContact.
134561847f8eSopenharmony_ci   * Returns {@code true} if the contact ID is in the local phone book; returns {@code false} otherwise.
134661847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
134761847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified. 2.Parameter verification failed.
134861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
134961847f8eSopenharmony_ci   * @since 10
135061847f8eSopenharmony_ci   */
135161847f8eSopenharmony_ci  function isLocalContact(context: Context, id: number, callback: AsyncCallback<boolean>): void;
135261847f8eSopenharmony_ci
135361847f8eSopenharmony_ci  /**
135461847f8eSopenharmony_ci   * Checks whether the contact ID is in the local phone book.
135561847f8eSopenharmony_ci   *
135661847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
135761847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
135861847f8eSopenharmony_ci   * @returns { Promise<boolean> } Returns {@code true} if the contact ID is in the local phone book,
135961847f8eSopenharmony_ci   * returns {@code false} otherwise.
136061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
136161847f8eSopenharmony_ci   * @since 7
136261847f8eSopenharmony_ci   * @deprecated since 10
136361847f8eSopenharmony_ci   * @useinstead contact.isLocalContact#isLocalContact
136461847f8eSopenharmony_ci   */
136561847f8eSopenharmony_ci  function isLocalContact(id: number): Promise<boolean>;
136661847f8eSopenharmony_ci
136761847f8eSopenharmony_ci  /**
136861847f8eSopenharmony_ci   * Checks whether the contact ID is in the local phone book.
136961847f8eSopenharmony_ci   *
137061847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
137161847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
137261847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
137361847f8eSopenharmony_ci   * @returns { Promise<boolean> } Returns {@code true} if the contact ID is in the local phone book,
137461847f8eSopenharmony_ci   * returns {@code false} otherwise.
137561847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
137661847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified. 2.Parameter verification failed.
137761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
137861847f8eSopenharmony_ci   * @since 10
137961847f8eSopenharmony_ci   */
138061847f8eSopenharmony_ci  function isLocalContact(context: Context, id: number): Promise<boolean>;
138161847f8eSopenharmony_ci
138261847f8eSopenharmony_ci  /**
138361847f8eSopenharmony_ci   * Checks whether the contact ID is of "my card".
138461847f8eSopenharmony_ci   *
138561847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
138661847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
138761847f8eSopenharmony_ci   * @param { AsyncCallback<boolean> } callback - The callback of isMyCard.
138861847f8eSopenharmony_ci   * Returns {@code true} if the contact ID is of "my card"; returns {@code false} otherwise.
138961847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
139061847f8eSopenharmony_ci   * @since 7
139161847f8eSopenharmony_ci   * @deprecated since 10
139261847f8eSopenharmony_ci   * @useinstead contact.deleteContact#deleteContact
139361847f8eSopenharmony_ci   */
139461847f8eSopenharmony_ci  function isMyCard(id: number, callback: AsyncCallback<boolean>): void;
139561847f8eSopenharmony_ci
139661847f8eSopenharmony_ci  /**
139761847f8eSopenharmony_ci   * Checks whether the contact ID is of "my card".
139861847f8eSopenharmony_ci   *
139961847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
140061847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
140161847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
140261847f8eSopenharmony_ci   * @param { AsyncCallback<boolean> } callback - The callback of isMyCard.
140361847f8eSopenharmony_ci   * Returns {@code true} if the contact ID is of "my card"; returns {@code false} otherwise.
140461847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
140561847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified. 2.Parameter verification failed.
140661847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
140761847f8eSopenharmony_ci   * @since 10
140861847f8eSopenharmony_ci   */
140961847f8eSopenharmony_ci  function isMyCard(context: Context, id: number, callback: AsyncCallback<boolean>): void;
141061847f8eSopenharmony_ci
141161847f8eSopenharmony_ci  /**
141261847f8eSopenharmony_ci   * Checks whether the contact ID is of "my card".
141361847f8eSopenharmony_ci   *
141461847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
141561847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
141661847f8eSopenharmony_ci   * @returns { Promise<boolean> } Returns true if the contact ID is of "my card", returns false otherwise.
141761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
141861847f8eSopenharmony_ci   * @since 7
141961847f8eSopenharmony_ci   * @deprecated since 10
142061847f8eSopenharmony_ci   * @useinstead contact.isMyCard#isMyCard
142161847f8eSopenharmony_ci   */
142261847f8eSopenharmony_ci  function isMyCard(id: number): Promise<boolean>;
142361847f8eSopenharmony_ci
142461847f8eSopenharmony_ci  /**
142561847f8eSopenharmony_ci   * Checks whether the contact ID is of "my card".
142661847f8eSopenharmony_ci   *
142761847f8eSopenharmony_ci   * @permission ohos.permission.READ_CONTACTS
142861847f8eSopenharmony_ci   * @param { Context } context - Indicates the context of application or capability.
142961847f8eSopenharmony_ci   * @param { number } id - Indicates the contact ID.
143061847f8eSopenharmony_ci   * @returns { Promise<boolean> } Returns true if the contact ID is of "my card", returns false otherwise.
143161847f8eSopenharmony_ci   * @throws { BusinessError } 201 - Permission denied.
143261847f8eSopenharmony_ci   * @throws { BusinessError } 401 - Parameter error. Possible causes: 1.Mandatory parameters are left unspecified. 2.Parameter verification failed.
143361847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
143461847f8eSopenharmony_ci   * @since 10
143561847f8eSopenharmony_ci   */
143661847f8eSopenharmony_ci  function isMyCard(context: Context, id: number): Promise<boolean>;
143761847f8eSopenharmony_ci
143861847f8eSopenharmony_ci  /**
143961847f8eSopenharmony_ci   * ContactSelectionOptions Object
144061847f8eSopenharmony_ci   *
144161847f8eSopenharmony_ci   * @interface ContactSelectionOptions
144261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.Contacts
144361847f8eSopenharmony_ci   * @since 10
144461847f8eSopenharmony_ci   */
144561847f8eSopenharmony_ci  /**
144661847f8eSopenharmony_ci   * ContactSelectionOptions Object
144761847f8eSopenharmony_ci   *
144861847f8eSopenharmony_ci   * @interface ContactSelectionOptions
144961847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.Contacts
145061847f8eSopenharmony_ci   * @atomicservice
145161847f8eSopenharmony_ci   * @since 11
145261847f8eSopenharmony_ci   */
145361847f8eSopenharmony_ci  interface ContactSelectionOptions {
145461847f8eSopenharmony_ci    /**
145561847f8eSopenharmony_ci     * Indicates the Single-select or multiple-select.
145661847f8eSopenharmony_ci     *
145761847f8eSopenharmony_ci     * @type { ?boolean }
145861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.Contacts
145961847f8eSopenharmony_ci     * @since 10
146061847f8eSopenharmony_ci     */
146161847f8eSopenharmony_ci    /**
146261847f8eSopenharmony_ci     * Indicates the Single-select or multiple-select.
146361847f8eSopenharmony_ci     *
146461847f8eSopenharmony_ci     * @type { ?boolean }
146561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.Contacts
146661847f8eSopenharmony_ci     * @atomicservice
146761847f8eSopenharmony_ci     * @since 11
146861847f8eSopenharmony_ci     */
146961847f8eSopenharmony_ci    isMultiSelect?: boolean;
147061847f8eSopenharmony_ci  }
147161847f8eSopenharmony_ci
147261847f8eSopenharmony_ci  /**
147361847f8eSopenharmony_ci   * Provides methods for contact information
147461847f8eSopenharmony_ci   *
147561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
147661847f8eSopenharmony_ci   * @since 7
147761847f8eSopenharmony_ci   */
147861847f8eSopenharmony_ci  /**
147961847f8eSopenharmony_ci   * Provides methods for contact information
148061847f8eSopenharmony_ci   *
148161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
148261847f8eSopenharmony_ci   * @atomicservice
148361847f8eSopenharmony_ci   * @since 11
148461847f8eSopenharmony_ci   */
148561847f8eSopenharmony_ci  class Contact {
148661847f8eSopenharmony_ci    /**
148761847f8eSopenharmony_ci     * Indicates the contact invalid ID.
148861847f8eSopenharmony_ci     *
148961847f8eSopenharmony_ci     * @type { number }
149061847f8eSopenharmony_ci     * @readonly
149161847f8eSopenharmony_ci     * @static
149261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
149361847f8eSopenharmony_ci     * @since 7
149461847f8eSopenharmony_ci     */
149561847f8eSopenharmony_ci    /**
149661847f8eSopenharmony_ci     * Indicates the contact invalid ID.
149761847f8eSopenharmony_ci     *
149861847f8eSopenharmony_ci     * @type { number }
149961847f8eSopenharmony_ci     * @readonly
150061847f8eSopenharmony_ci     * @static
150161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
150261847f8eSopenharmony_ci     * @atomicservice
150361847f8eSopenharmony_ci     * @since 11
150461847f8eSopenharmony_ci     */
150561847f8eSopenharmony_ci    static readonly INVALID_CONTACT_ID: -1
150661847f8eSopenharmony_ci
150761847f8eSopenharmony_ci    /**
150861847f8eSopenharmony_ci     * Indicates the contact ID.
150961847f8eSopenharmony_ci     *
151061847f8eSopenharmony_ci     * @type { ?number }
151161847f8eSopenharmony_ci     * @readonly
151261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
151361847f8eSopenharmony_ci     * @since 7
151461847f8eSopenharmony_ci     */
151561847f8eSopenharmony_ci    /**
151661847f8eSopenharmony_ci     * Indicates the contact ID.
151761847f8eSopenharmony_ci     *
151861847f8eSopenharmony_ci     * @type { ?number }
151961847f8eSopenharmony_ci     * @readonly
152061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
152161847f8eSopenharmony_ci     * @atomicservice
152261847f8eSopenharmony_ci     * @since 11
152361847f8eSopenharmony_ci     */
152461847f8eSopenharmony_ci    readonly id?: number
152561847f8eSopenharmony_ci
152661847f8eSopenharmony_ci    /**
152761847f8eSopenharmony_ci     * Indicates the query key that identifies the contact.
152861847f8eSopenharmony_ci     *
152961847f8eSopenharmony_ci     * @type { ?string }
153061847f8eSopenharmony_ci     * @readonly
153161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
153261847f8eSopenharmony_ci     * @since 7
153361847f8eSopenharmony_ci     */
153461847f8eSopenharmony_ci    /**
153561847f8eSopenharmony_ci     * Indicates the query key that identifies the contact.
153661847f8eSopenharmony_ci     *
153761847f8eSopenharmony_ci     * @type { ?string }
153861847f8eSopenharmony_ci     * @readonly
153961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
154061847f8eSopenharmony_ci     * @atomicservice
154161847f8eSopenharmony_ci     * @since 11
154261847f8eSopenharmony_ci     */
154361847f8eSopenharmony_ci    readonly key?: string
154461847f8eSopenharmony_ci
154561847f8eSopenharmony_ci    /**
154661847f8eSopenharmony_ci     * Indicates the contact attributes.
154761847f8eSopenharmony_ci     *
154861847f8eSopenharmony_ci     * @type { ?ContactAttributes }
154961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
155061847f8eSopenharmony_ci     * @since 7
155161847f8eSopenharmony_ci     */
155261847f8eSopenharmony_ci    /**
155361847f8eSopenharmony_ci     * Indicates the contact attributes.
155461847f8eSopenharmony_ci     *
155561847f8eSopenharmony_ci     * @type { ?ContactAttributes }
155661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
155761847f8eSopenharmony_ci     * @atomicservice
155861847f8eSopenharmony_ci     * @since 11
155961847f8eSopenharmony_ci     */
156061847f8eSopenharmony_ci    contactAttributes?: ContactAttributes
156161847f8eSopenharmony_ci
156261847f8eSopenharmony_ci    /**
156361847f8eSopenharmony_ci     * Indicates list of contact email addresses.
156461847f8eSopenharmony_ci     *
156561847f8eSopenharmony_ci     * @type { ?Email[] }
156661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
156761847f8eSopenharmony_ci     * @since 7
156861847f8eSopenharmony_ci     */
156961847f8eSopenharmony_ci    /**
157061847f8eSopenharmony_ci     * Indicates list of contact email addresses.
157161847f8eSopenharmony_ci     *
157261847f8eSopenharmony_ci     * @type { ?Email[] }
157361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
157461847f8eSopenharmony_ci     * @atomicservice
157561847f8eSopenharmony_ci     * @since 11
157661847f8eSopenharmony_ci     */
157761847f8eSopenharmony_ci    emails?: Email[]
157861847f8eSopenharmony_ci
157961847f8eSopenharmony_ci    /**
158061847f8eSopenharmony_ci     * Indicates an event (special date) of the contact.
158161847f8eSopenharmony_ci     *
158261847f8eSopenharmony_ci     * @type { ?Event[] }
158361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
158461847f8eSopenharmony_ci     * @since 7
158561847f8eSopenharmony_ci     */
158661847f8eSopenharmony_ci    /**
158761847f8eSopenharmony_ci     * Indicates an event (special date) of the contact.
158861847f8eSopenharmony_ci     *
158961847f8eSopenharmony_ci     * @type { ?Event[] }
159061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
159161847f8eSopenharmony_ci     * @atomicservice
159261847f8eSopenharmony_ci     * @since 11
159361847f8eSopenharmony_ci     */
159461847f8eSopenharmony_ci    events?: Event[]
159561847f8eSopenharmony_ci
159661847f8eSopenharmony_ci    /**
159761847f8eSopenharmony_ci     * Indicates a group of the contact.
159861847f8eSopenharmony_ci     *
159961847f8eSopenharmony_ci     * @type { ?Group[] }
160061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
160161847f8eSopenharmony_ci     * @since 7
160261847f8eSopenharmony_ci     */
160361847f8eSopenharmony_ci    /**
160461847f8eSopenharmony_ci     * Indicates a group of the contact.
160561847f8eSopenharmony_ci     *
160661847f8eSopenharmony_ci     * @type { ?Group[] }
160761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
160861847f8eSopenharmony_ci     * @atomicservice
160961847f8eSopenharmony_ci     * @since 11
161061847f8eSopenharmony_ci     */
161161847f8eSopenharmony_ci    groups?: Group[]
161261847f8eSopenharmony_ci
161361847f8eSopenharmony_ci    /**
161461847f8eSopenharmony_ci     * Indicates an IM address of the contact.
161561847f8eSopenharmony_ci     *
161661847f8eSopenharmony_ci     * @type { ?ImAddress[] }
161761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
161861847f8eSopenharmony_ci     * @since 7
161961847f8eSopenharmony_ci     */
162061847f8eSopenharmony_ci    /**
162161847f8eSopenharmony_ci     * Indicates an IM address of the contact.
162261847f8eSopenharmony_ci     *
162361847f8eSopenharmony_ci     * @type { ?ImAddress[] }
162461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
162561847f8eSopenharmony_ci     * @atomicservice
162661847f8eSopenharmony_ci     * @since 11
162761847f8eSopenharmony_ci     */
162861847f8eSopenharmony_ci    imAddresses?: ImAddress[]
162961847f8eSopenharmony_ci
163061847f8eSopenharmony_ci    /**
163161847f8eSopenharmony_ci     * Indicates a phone number of the contact.
163261847f8eSopenharmony_ci     *
163361847f8eSopenharmony_ci     * @type { ?PhoneNumber[] }
163461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
163561847f8eSopenharmony_ci     * @since 7
163661847f8eSopenharmony_ci     */
163761847f8eSopenharmony_ci    /**
163861847f8eSopenharmony_ci     * Indicates a phone number of the contact.
163961847f8eSopenharmony_ci     *
164061847f8eSopenharmony_ci     * @type { ?PhoneNumber[] }
164161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
164261847f8eSopenharmony_ci     * @atomicservice
164361847f8eSopenharmony_ci     * @since 11
164461847f8eSopenharmony_ci     */
164561847f8eSopenharmony_ci    phoneNumbers?: PhoneNumber[]
164661847f8eSopenharmony_ci
164761847f8eSopenharmony_ci    /**
164861847f8eSopenharmony_ci     * Indicates the contact portrait.
164961847f8eSopenharmony_ci     *
165061847f8eSopenharmony_ci     * @type { ?Portrait }
165161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
165261847f8eSopenharmony_ci     * @since 7
165361847f8eSopenharmony_ci     */
165461847f8eSopenharmony_ci    /**
165561847f8eSopenharmony_ci     * Indicates the contact portrait.
165661847f8eSopenharmony_ci     *
165761847f8eSopenharmony_ci     * @type { ?Portrait }
165861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
165961847f8eSopenharmony_ci     * @atomicservice
166061847f8eSopenharmony_ci     * @since 11
166161847f8eSopenharmony_ci     */
166261847f8eSopenharmony_ci    portrait?: Portrait
166361847f8eSopenharmony_ci
166461847f8eSopenharmony_ci    /**
166561847f8eSopenharmony_ci     * Indicates a postal address of the contact.
166661847f8eSopenharmony_ci     *
166761847f8eSopenharmony_ci     * @type { ?PostalAddress[] }
166861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
166961847f8eSopenharmony_ci     * @since 7
167061847f8eSopenharmony_ci     */
167161847f8eSopenharmony_ci    /**
167261847f8eSopenharmony_ci     * Indicates a postal address of the contact.
167361847f8eSopenharmony_ci     *
167461847f8eSopenharmony_ci     * @type { ?PostalAddress[] }
167561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
167661847f8eSopenharmony_ci     * @atomicservice
167761847f8eSopenharmony_ci     * @since 11
167861847f8eSopenharmony_ci     */
167961847f8eSopenharmony_ci    postalAddresses?: PostalAddress[]
168061847f8eSopenharmony_ci
168161847f8eSopenharmony_ci    /**
168261847f8eSopenharmony_ci     * Indicates a relation of the contact.
168361847f8eSopenharmony_ci     *
168461847f8eSopenharmony_ci     * @type { ?Relation[] }
168561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
168661847f8eSopenharmony_ci     * @since 7
168761847f8eSopenharmony_ci     */
168861847f8eSopenharmony_ci    /**
168961847f8eSopenharmony_ci     * Indicates a relation of the contact.
169061847f8eSopenharmony_ci     *
169161847f8eSopenharmony_ci     * @type { ?Relation[] }
169261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
169361847f8eSopenharmony_ci     * @atomicservice
169461847f8eSopenharmony_ci     * @since 11
169561847f8eSopenharmony_ci     */
169661847f8eSopenharmony_ci    relations?: Relation[]
169761847f8eSopenharmony_ci
169861847f8eSopenharmony_ci    /**
169961847f8eSopenharmony_ci     * Indicates a Session Initiation Protocol (SIP) address of the contact.
170061847f8eSopenharmony_ci     *
170161847f8eSopenharmony_ci     * @type { ?SipAddress[] }
170261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
170361847f8eSopenharmony_ci     * @since 7
170461847f8eSopenharmony_ci     */
170561847f8eSopenharmony_ci    /**
170661847f8eSopenharmony_ci     * Indicates a Session Initiation Protocol (SIP) address of the contact.
170761847f8eSopenharmony_ci     *
170861847f8eSopenharmony_ci     * @type { ?SipAddress[] }
170961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
171061847f8eSopenharmony_ci     * @atomicservice
171161847f8eSopenharmony_ci     * @since 11
171261847f8eSopenharmony_ci     */
171361847f8eSopenharmony_ci    sipAddresses?: SipAddress[]
171461847f8eSopenharmony_ci
171561847f8eSopenharmony_ci    /**
171661847f8eSopenharmony_ci     * Indicates a website of the contact.
171761847f8eSopenharmony_ci     *
171861847f8eSopenharmony_ci     * @type { ?Website[] }
171961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
172061847f8eSopenharmony_ci     * @since 7
172161847f8eSopenharmony_ci     */
172261847f8eSopenharmony_ci    /**
172361847f8eSopenharmony_ci     * Indicates a website of the contact.
172461847f8eSopenharmony_ci     *
172561847f8eSopenharmony_ci     * @type { ?Website[] }
172661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
172761847f8eSopenharmony_ci     * @atomicservice
172861847f8eSopenharmony_ci     * @since 11
172961847f8eSopenharmony_ci     */
173061847f8eSopenharmony_ci    websites?: Website[]
173161847f8eSopenharmony_ci
173261847f8eSopenharmony_ci    /**
173361847f8eSopenharmony_ci     * Indicates the contact name.
173461847f8eSopenharmony_ci     *
173561847f8eSopenharmony_ci     * @type { ?Name }
173661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
173761847f8eSopenharmony_ci     * @since 7
173861847f8eSopenharmony_ci     */
173961847f8eSopenharmony_ci    /**
174061847f8eSopenharmony_ci     * Indicates the contact name.
174161847f8eSopenharmony_ci     *
174261847f8eSopenharmony_ci     * @type { ?Name }
174361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
174461847f8eSopenharmony_ci     * @atomicservice
174561847f8eSopenharmony_ci     * @since 11
174661847f8eSopenharmony_ci     */
174761847f8eSopenharmony_ci    name?: Name
174861847f8eSopenharmony_ci
174961847f8eSopenharmony_ci    /**
175061847f8eSopenharmony_ci     * Indicates the contact nickname.
175161847f8eSopenharmony_ci     *
175261847f8eSopenharmony_ci     * @type { ?NickName }
175361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
175461847f8eSopenharmony_ci     * @since 7
175561847f8eSopenharmony_ci     */
175661847f8eSopenharmony_ci    /**
175761847f8eSopenharmony_ci     * Indicates the contact nickname.
175861847f8eSopenharmony_ci     *
175961847f8eSopenharmony_ci     * @type { ?NickName }
176061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
176161847f8eSopenharmony_ci     * @atomicservice
176261847f8eSopenharmony_ci     * @since 11
176361847f8eSopenharmony_ci     */
176461847f8eSopenharmony_ci    nickName?: NickName
176561847f8eSopenharmony_ci
176661847f8eSopenharmony_ci    /**
176761847f8eSopenharmony_ci     * Indicates the contact note.
176861847f8eSopenharmony_ci     *
176961847f8eSopenharmony_ci     * @type { ?Note }
177061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
177161847f8eSopenharmony_ci     * @since 7
177261847f8eSopenharmony_ci     */
177361847f8eSopenharmony_ci    /**
177461847f8eSopenharmony_ci     * Indicates the contact note.
177561847f8eSopenharmony_ci     *
177661847f8eSopenharmony_ci     * @type { ?Note }
177761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
177861847f8eSopenharmony_ci     * @atomicservice
177961847f8eSopenharmony_ci     * @since 11
178061847f8eSopenharmony_ci     */
178161847f8eSopenharmony_ci    note?: Note
178261847f8eSopenharmony_ci
178361847f8eSopenharmony_ci    /**
178461847f8eSopenharmony_ci     * Indicates organization information about the contact.
178561847f8eSopenharmony_ci     *
178661847f8eSopenharmony_ci     * @type { ?Organization }
178761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
178861847f8eSopenharmony_ci     * @since 7
178961847f8eSopenharmony_ci     */
179061847f8eSopenharmony_ci    /**
179161847f8eSopenharmony_ci     * Indicates organization information about the contact.
179261847f8eSopenharmony_ci     *
179361847f8eSopenharmony_ci     * @type { ?Organization }
179461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
179561847f8eSopenharmony_ci     * @atomicservice
179661847f8eSopenharmony_ci     * @since 11
179761847f8eSopenharmony_ci     */
179861847f8eSopenharmony_ci    organization?: Organization
179961847f8eSopenharmony_ci  }
180061847f8eSopenharmony_ci
180161847f8eSopenharmony_ci  /**
180261847f8eSopenharmony_ci   * Provides methods for contact attributes information
180361847f8eSopenharmony_ci   *
180461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
180561847f8eSopenharmony_ci   * @since 7
180661847f8eSopenharmony_ci   */
180761847f8eSopenharmony_ci  /**
180861847f8eSopenharmony_ci   * Provides methods for contact attributes information
180961847f8eSopenharmony_ci   *
181061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
181161847f8eSopenharmony_ci   * @atomicservice
181261847f8eSopenharmony_ci   * @since 11
181361847f8eSopenharmony_ci   */
181461847f8eSopenharmony_ci  class ContactAttributes {
181561847f8eSopenharmony_ci    /**
181661847f8eSopenharmony_ci     * Indicates the contact attributes.
181761847f8eSopenharmony_ci     *
181861847f8eSopenharmony_ci     * @type { Attribute[] }
181961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
182061847f8eSopenharmony_ci     * @since 7
182161847f8eSopenharmony_ci     */
182261847f8eSopenharmony_ci    /**
182361847f8eSopenharmony_ci     * Indicates the contact attributes.
182461847f8eSopenharmony_ci     *
182561847f8eSopenharmony_ci     * @type { Attribute[] }
182661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
182761847f8eSopenharmony_ci     * @atomicservice
182861847f8eSopenharmony_ci     * @since 11
182961847f8eSopenharmony_ci     */
183061847f8eSopenharmony_ci    attributes: Attribute[]
183161847f8eSopenharmony_ci  }
183261847f8eSopenharmony_ci
183361847f8eSopenharmony_ci  /**
183461847f8eSopenharmony_ci   * Provides methods for attribute information
183561847f8eSopenharmony_ci   *
183661847f8eSopenharmony_ci   * @enum { number }
183761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
183861847f8eSopenharmony_ci   * @since 7
183961847f8eSopenharmony_ci   */
184061847f8eSopenharmony_ci  /**
184161847f8eSopenharmony_ci   * Provides methods for attribute information
184261847f8eSopenharmony_ci   *
184361847f8eSopenharmony_ci   * @enum { number }
184461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
184561847f8eSopenharmony_ci   * @atomicservice
184661847f8eSopenharmony_ci   * @since 11
184761847f8eSopenharmony_ci   */
184861847f8eSopenharmony_ci  enum Attribute {
184961847f8eSopenharmony_ci    /**
185061847f8eSopenharmony_ci     * Indicates the contact event.
185161847f8eSopenharmony_ci     *
185261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
185361847f8eSopenharmony_ci     * @since 7
185461847f8eSopenharmony_ci     */
185561847f8eSopenharmony_ci    /**
185661847f8eSopenharmony_ci     * Indicates the contact event.
185761847f8eSopenharmony_ci     *
185861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
185961847f8eSopenharmony_ci     * @atomicservice
186061847f8eSopenharmony_ci     * @since 11
186161847f8eSopenharmony_ci     */
186261847f8eSopenharmony_ci    ATTR_CONTACT_EVENT,
186361847f8eSopenharmony_ci
186461847f8eSopenharmony_ci    /**
186561847f8eSopenharmony_ci     * Indicates the email address.
186661847f8eSopenharmony_ci     *
186761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
186861847f8eSopenharmony_ci     * @since 7
186961847f8eSopenharmony_ci     */
187061847f8eSopenharmony_ci    /**
187161847f8eSopenharmony_ci     * Indicates the email address.
187261847f8eSopenharmony_ci     *
187361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
187461847f8eSopenharmony_ci     * @atomicservice
187561847f8eSopenharmony_ci     * @since 11
187661847f8eSopenharmony_ci     */
187761847f8eSopenharmony_ci    ATTR_EMAIL,
187861847f8eSopenharmony_ci
187961847f8eSopenharmony_ci    /**
188061847f8eSopenharmony_ci     * Indicates the contact group.
188161847f8eSopenharmony_ci     *
188261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
188361847f8eSopenharmony_ci     * @since 7
188461847f8eSopenharmony_ci     */
188561847f8eSopenharmony_ci    /**
188661847f8eSopenharmony_ci     * Indicates the contact group.
188761847f8eSopenharmony_ci     *
188861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
188961847f8eSopenharmony_ci     * @atomicservice
189061847f8eSopenharmony_ci     * @since 11
189161847f8eSopenharmony_ci     */
189261847f8eSopenharmony_ci    ATTR_GROUP_MEMBERSHIP,
189361847f8eSopenharmony_ci
189461847f8eSopenharmony_ci    /**
189561847f8eSopenharmony_ci     * Indicates the instant messaging (IM) address.
189661847f8eSopenharmony_ci     *
189761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
189861847f8eSopenharmony_ci     * @since 7
189961847f8eSopenharmony_ci     */
190061847f8eSopenharmony_ci    /**
190161847f8eSopenharmony_ci     * Indicates the instant messaging (IM) address.
190261847f8eSopenharmony_ci     *
190361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
190461847f8eSopenharmony_ci     * @atomicservice
190561847f8eSopenharmony_ci     * @since 11
190661847f8eSopenharmony_ci     */
190761847f8eSopenharmony_ci    ATTR_IM,
190861847f8eSopenharmony_ci
190961847f8eSopenharmony_ci    /**
191061847f8eSopenharmony_ci     * Indicates the name.
191161847f8eSopenharmony_ci     *
191261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
191361847f8eSopenharmony_ci     * @since 7
191461847f8eSopenharmony_ci     */
191561847f8eSopenharmony_ci    /**
191661847f8eSopenharmony_ci     * Indicates the name.
191761847f8eSopenharmony_ci     *
191861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
191961847f8eSopenharmony_ci     * @atomicservice
192061847f8eSopenharmony_ci     * @since 11
192161847f8eSopenharmony_ci     */
192261847f8eSopenharmony_ci    ATTR_NAME,
192361847f8eSopenharmony_ci
192461847f8eSopenharmony_ci    /**
192561847f8eSopenharmony_ci     * Indicates the nickname.
192661847f8eSopenharmony_ci     *
192761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
192861847f8eSopenharmony_ci     * @since 7
192961847f8eSopenharmony_ci     */
193061847f8eSopenharmony_ci    /**
193161847f8eSopenharmony_ci     * Indicates the nickname.
193261847f8eSopenharmony_ci     *
193361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
193461847f8eSopenharmony_ci     * @atomicservice
193561847f8eSopenharmony_ci     * @since 11
193661847f8eSopenharmony_ci     */
193761847f8eSopenharmony_ci    ATTR_NICKNAME,
193861847f8eSopenharmony_ci
193961847f8eSopenharmony_ci    /**
194061847f8eSopenharmony_ci     * Indicates the note.
194161847f8eSopenharmony_ci     *
194261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
194361847f8eSopenharmony_ci     * @since 7
194461847f8eSopenharmony_ci     */
194561847f8eSopenharmony_ci    /**
194661847f8eSopenharmony_ci     * Indicates the note.
194761847f8eSopenharmony_ci     *
194861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
194961847f8eSopenharmony_ci     * @atomicservice
195061847f8eSopenharmony_ci     * @since 11
195161847f8eSopenharmony_ci     */
195261847f8eSopenharmony_ci    ATTR_NOTE,
195361847f8eSopenharmony_ci
195461847f8eSopenharmony_ci    /**
195561847f8eSopenharmony_ci     * Indicates the organization.
195661847f8eSopenharmony_ci     *
195761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
195861847f8eSopenharmony_ci     * @since 7
195961847f8eSopenharmony_ci     */
196061847f8eSopenharmony_ci    /**
196161847f8eSopenharmony_ci     * Indicates the organization.
196261847f8eSopenharmony_ci     *
196361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
196461847f8eSopenharmony_ci     * @atomicservice
196561847f8eSopenharmony_ci     * @since 11
196661847f8eSopenharmony_ci     */
196761847f8eSopenharmony_ci    ATTR_ORGANIZATION,
196861847f8eSopenharmony_ci
196961847f8eSopenharmony_ci    /**
197061847f8eSopenharmony_ci     * Indicates the phone number.
197161847f8eSopenharmony_ci     *
197261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
197361847f8eSopenharmony_ci     * @since 7
197461847f8eSopenharmony_ci     */
197561847f8eSopenharmony_ci    /**
197661847f8eSopenharmony_ci     * Indicates the phone number.
197761847f8eSopenharmony_ci     *
197861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
197961847f8eSopenharmony_ci     * @atomicservice
198061847f8eSopenharmony_ci     * @since 11
198161847f8eSopenharmony_ci     */
198261847f8eSopenharmony_ci    ATTR_PHONE,
198361847f8eSopenharmony_ci
198461847f8eSopenharmony_ci    /**
198561847f8eSopenharmony_ci     * Indicates the portrait.
198661847f8eSopenharmony_ci     *
198761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
198861847f8eSopenharmony_ci     * @since 7
198961847f8eSopenharmony_ci     */
199061847f8eSopenharmony_ci    /**
199161847f8eSopenharmony_ci     * Indicates the portrait.
199261847f8eSopenharmony_ci     *
199361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
199461847f8eSopenharmony_ci     * @atomicservice
199561847f8eSopenharmony_ci     * @since 11
199661847f8eSopenharmony_ci     */
199761847f8eSopenharmony_ci    ATTR_PORTRAIT,
199861847f8eSopenharmony_ci
199961847f8eSopenharmony_ci    /**
200061847f8eSopenharmony_ci     * Indicates the postal address.
200161847f8eSopenharmony_ci     *
200261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
200361847f8eSopenharmony_ci     * @since 7
200461847f8eSopenharmony_ci     */
200561847f8eSopenharmony_ci    /**
200661847f8eSopenharmony_ci     * Indicates the postal address.
200761847f8eSopenharmony_ci     *
200861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
200961847f8eSopenharmony_ci     * @atomicservice
201061847f8eSopenharmony_ci     * @since 11
201161847f8eSopenharmony_ci     */
201261847f8eSopenharmony_ci    ATTR_POSTAL_ADDRESS,
201361847f8eSopenharmony_ci
201461847f8eSopenharmony_ci    /**
201561847f8eSopenharmony_ci     * Indicates the relation.
201661847f8eSopenharmony_ci     *
201761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
201861847f8eSopenharmony_ci     * @since 7
201961847f8eSopenharmony_ci     */
202061847f8eSopenharmony_ci    /**
202161847f8eSopenharmony_ci     * Indicates the relation.
202261847f8eSopenharmony_ci     *
202361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
202461847f8eSopenharmony_ci     * @atomicservice
202561847f8eSopenharmony_ci     * @since 11
202661847f8eSopenharmony_ci     */
202761847f8eSopenharmony_ci    ATTR_RELATION,
202861847f8eSopenharmony_ci
202961847f8eSopenharmony_ci    /**
203061847f8eSopenharmony_ci     * Indicates the Session Initiation Protocol (SIP) address.
203161847f8eSopenharmony_ci     *
203261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
203361847f8eSopenharmony_ci     * @since 7
203461847f8eSopenharmony_ci     */
203561847f8eSopenharmony_ci    /**
203661847f8eSopenharmony_ci     * Indicates the Session Initiation Protocol (SIP) address.
203761847f8eSopenharmony_ci     *
203861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
203961847f8eSopenharmony_ci     * @atomicservice
204061847f8eSopenharmony_ci     * @since 11
204161847f8eSopenharmony_ci     */
204261847f8eSopenharmony_ci    ATTR_SIP_ADDRESS,
204361847f8eSopenharmony_ci
204461847f8eSopenharmony_ci    /**
204561847f8eSopenharmony_ci     * Indicates the website.
204661847f8eSopenharmony_ci     *
204761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
204861847f8eSopenharmony_ci     * @since 7
204961847f8eSopenharmony_ci     */
205061847f8eSopenharmony_ci    /**
205161847f8eSopenharmony_ci     * Indicates the website.
205261847f8eSopenharmony_ci     *
205361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
205461847f8eSopenharmony_ci     * @atomicservice
205561847f8eSopenharmony_ci     * @since 11
205661847f8eSopenharmony_ci     */
205761847f8eSopenharmony_ci    ATTR_WEBSITE
205861847f8eSopenharmony_ci  }
205961847f8eSopenharmony_ci
206061847f8eSopenharmony_ci  /**
206161847f8eSopenharmony_ci   * Provides methods for email information
206261847f8eSopenharmony_ci   *
206361847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
206461847f8eSopenharmony_ci   * @since 7
206561847f8eSopenharmony_ci   */
206661847f8eSopenharmony_ci  /**
206761847f8eSopenharmony_ci   * Provides methods for email information
206861847f8eSopenharmony_ci   *
206961847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
207061847f8eSopenharmony_ci   * @atomicservice
207161847f8eSopenharmony_ci   * @since 11
207261847f8eSopenharmony_ci   */
207361847f8eSopenharmony_ci  class Email {
207461847f8eSopenharmony_ci    /**
207561847f8eSopenharmony_ci     * Indicates a custom label.
207661847f8eSopenharmony_ci     *
207761847f8eSopenharmony_ci     * @type { number }
207861847f8eSopenharmony_ci     * @readonly
207961847f8eSopenharmony_ci     * @static
208061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
208161847f8eSopenharmony_ci     * @since 7
208261847f8eSopenharmony_ci     */
208361847f8eSopenharmony_ci    /**
208461847f8eSopenharmony_ci     * Indicates a custom label.
208561847f8eSopenharmony_ci     *
208661847f8eSopenharmony_ci     * @type { number }
208761847f8eSopenharmony_ci     * @readonly
208861847f8eSopenharmony_ci     * @static
208961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
209061847f8eSopenharmony_ci     * @atomicservice
209161847f8eSopenharmony_ci     * @since 11
209261847f8eSopenharmony_ci     */
209361847f8eSopenharmony_ci    static readonly CUSTOM_LABEL: 0
209461847f8eSopenharmony_ci
209561847f8eSopenharmony_ci    /**
209661847f8eSopenharmony_ci     * Indicates a home email.
209761847f8eSopenharmony_ci     *
209861847f8eSopenharmony_ci     * @type { number }
209961847f8eSopenharmony_ci     * @readonly
210061847f8eSopenharmony_ci     * @static
210161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
210261847f8eSopenharmony_ci     * @since 7
210361847f8eSopenharmony_ci     */
210461847f8eSopenharmony_ci    /**
210561847f8eSopenharmony_ci     * Indicates a home email.
210661847f8eSopenharmony_ci     *
210761847f8eSopenharmony_ci     * @type { number }
210861847f8eSopenharmony_ci     * @readonly
210961847f8eSopenharmony_ci     * @static
211061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
211161847f8eSopenharmony_ci     * @atomicservice
211261847f8eSopenharmony_ci     * @since 11
211361847f8eSopenharmony_ci     */
211461847f8eSopenharmony_ci    static readonly EMAIL_HOME: 1
211561847f8eSopenharmony_ci
211661847f8eSopenharmony_ci    /**
211761847f8eSopenharmony_ci     * Indicates a work email.
211861847f8eSopenharmony_ci     *
211961847f8eSopenharmony_ci     * @type { number }
212061847f8eSopenharmony_ci     * @readonly
212161847f8eSopenharmony_ci     * @static
212261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
212361847f8eSopenharmony_ci     * @since 7
212461847f8eSopenharmony_ci     */
212561847f8eSopenharmony_ci    /**
212661847f8eSopenharmony_ci     * Indicates a work email.
212761847f8eSopenharmony_ci     *
212861847f8eSopenharmony_ci     * @type { number }
212961847f8eSopenharmony_ci     * @readonly
213061847f8eSopenharmony_ci     * @static
213161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
213261847f8eSopenharmony_ci     * @atomicservice
213361847f8eSopenharmony_ci     * @since 11
213461847f8eSopenharmony_ci     */
213561847f8eSopenharmony_ci    static readonly EMAIL_WORK: 2
213661847f8eSopenharmony_ci
213761847f8eSopenharmony_ci    /**
213861847f8eSopenharmony_ci     * Indicates an email of the OTHER type.
213961847f8eSopenharmony_ci     *
214061847f8eSopenharmony_ci     * @type { number }
214161847f8eSopenharmony_ci     * @readonly
214261847f8eSopenharmony_ci     * @static
214361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
214461847f8eSopenharmony_ci     * @since 7
214561847f8eSopenharmony_ci     */
214661847f8eSopenharmony_ci    /**
214761847f8eSopenharmony_ci     * Indicates an email of the OTHER type.
214861847f8eSopenharmony_ci     *
214961847f8eSopenharmony_ci     * @type { number }
215061847f8eSopenharmony_ci     * @readonly
215161847f8eSopenharmony_ci     * @static
215261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
215361847f8eSopenharmony_ci     * @atomicservice
215461847f8eSopenharmony_ci     * @since 11
215561847f8eSopenharmony_ci     */
215661847f8eSopenharmony_ci    static readonly EMAIL_OTHER: 3
215761847f8eSopenharmony_ci
215861847f8eSopenharmony_ci    /**
215961847f8eSopenharmony_ci     * Indicates an invalid label ID.
216061847f8eSopenharmony_ci     *
216161847f8eSopenharmony_ci     * @type { number }
216261847f8eSopenharmony_ci     * @readonly
216361847f8eSopenharmony_ci     * @static
216461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
216561847f8eSopenharmony_ci     * @since 7
216661847f8eSopenharmony_ci     */
216761847f8eSopenharmony_ci    /**
216861847f8eSopenharmony_ci     * Indicates an invalid label ID.
216961847f8eSopenharmony_ci     *
217061847f8eSopenharmony_ci     * @type { number }
217161847f8eSopenharmony_ci     * @readonly
217261847f8eSopenharmony_ci     * @static
217361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
217461847f8eSopenharmony_ci     * @atomicservice
217561847f8eSopenharmony_ci     * @since 11
217661847f8eSopenharmony_ci     */
217761847f8eSopenharmony_ci    static readonly INVALID_LABEL_ID: -1
217861847f8eSopenharmony_ci
217961847f8eSopenharmony_ci    /**
218061847f8eSopenharmony_ci     * Indicates the email address.
218161847f8eSopenharmony_ci     *
218261847f8eSopenharmony_ci     * @type { string }
218361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
218461847f8eSopenharmony_ci     * @since 7
218561847f8eSopenharmony_ci     */
218661847f8eSopenharmony_ci    /**
218761847f8eSopenharmony_ci     * Indicates the email address.
218861847f8eSopenharmony_ci     *
218961847f8eSopenharmony_ci     * @type { string }
219061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
219161847f8eSopenharmony_ci     * @atomicservice
219261847f8eSopenharmony_ci     * @since 11
219361847f8eSopenharmony_ci     */
219461847f8eSopenharmony_ci    email: string
219561847f8eSopenharmony_ci
219661847f8eSopenharmony_ci    /**
219761847f8eSopenharmony_ci     * Indicates the label name of an attribute.
219861847f8eSopenharmony_ci     *
219961847f8eSopenharmony_ci     * @type { ?string }
220061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
220161847f8eSopenharmony_ci     * @since 7
220261847f8eSopenharmony_ci     */
220361847f8eSopenharmony_ci    /**
220461847f8eSopenharmony_ci     * Indicates the label name of an attribute.
220561847f8eSopenharmony_ci     *
220661847f8eSopenharmony_ci     * @type { ?string }
220761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
220861847f8eSopenharmony_ci     * @atomicservice
220961847f8eSopenharmony_ci     * @since 11
221061847f8eSopenharmony_ci     */
221161847f8eSopenharmony_ci    labelName?: string
221261847f8eSopenharmony_ci
221361847f8eSopenharmony_ci    /**
221461847f8eSopenharmony_ci     * Indicates the displayed email name.
221561847f8eSopenharmony_ci     *
221661847f8eSopenharmony_ci     * @type { ?string }
221761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
221861847f8eSopenharmony_ci     * @since 7
221961847f8eSopenharmony_ci     */
222061847f8eSopenharmony_ci    /**
222161847f8eSopenharmony_ci     * Indicates the displayed email name.
222261847f8eSopenharmony_ci     *
222361847f8eSopenharmony_ci     * @type { ?string }
222461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
222561847f8eSopenharmony_ci     * @atomicservice
222661847f8eSopenharmony_ci     * @since 11
222761847f8eSopenharmony_ci     */
222861847f8eSopenharmony_ci    displayName?: string
222961847f8eSopenharmony_ci
223061847f8eSopenharmony_ci    /**
223161847f8eSopenharmony_ci     * Indicates the label id.
223261847f8eSopenharmony_ci     *
223361847f8eSopenharmony_ci     * @type { ?number }
223461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
223561847f8eSopenharmony_ci     * @since 7
223661847f8eSopenharmony_ci     */
223761847f8eSopenharmony_ci    /**
223861847f8eSopenharmony_ci     * Indicates the label id.
223961847f8eSopenharmony_ci     *
224061847f8eSopenharmony_ci     * @type { ?number }
224161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
224261847f8eSopenharmony_ci     * @atomicservice
224361847f8eSopenharmony_ci     * @since 11
224461847f8eSopenharmony_ci     */
224561847f8eSopenharmony_ci    labelId?: number
224661847f8eSopenharmony_ci  }
224761847f8eSopenharmony_ci
224861847f8eSopenharmony_ci  /**
224961847f8eSopenharmony_ci   * Provides methods for event information
225061847f8eSopenharmony_ci   *
225161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
225261847f8eSopenharmony_ci   * @since 7
225361847f8eSopenharmony_ci   */
225461847f8eSopenharmony_ci  /**
225561847f8eSopenharmony_ci   * Provides methods for event information
225661847f8eSopenharmony_ci   *
225761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
225861847f8eSopenharmony_ci   * @atomicservice
225961847f8eSopenharmony_ci   * @since 11
226061847f8eSopenharmony_ci   */
226161847f8eSopenharmony_ci  class Event {
226261847f8eSopenharmony_ci    /**
226361847f8eSopenharmony_ci     * Indicates a custom label.
226461847f8eSopenharmony_ci     *
226561847f8eSopenharmony_ci     * @type { number }
226661847f8eSopenharmony_ci     * @readonly
226761847f8eSopenharmony_ci     * @static
226861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
226961847f8eSopenharmony_ci     * @since 7
227061847f8eSopenharmony_ci     */
227161847f8eSopenharmony_ci    /**
227261847f8eSopenharmony_ci     * Indicates a custom label.
227361847f8eSopenharmony_ci     *
227461847f8eSopenharmony_ci     * @type { number }
227561847f8eSopenharmony_ci     * @readonly
227661847f8eSopenharmony_ci     * @static
227761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
227861847f8eSopenharmony_ci     * @atomicservice
227961847f8eSopenharmony_ci     * @since 11
228061847f8eSopenharmony_ci     */
228161847f8eSopenharmony_ci    static readonly CUSTOM_LABEL: 0
228261847f8eSopenharmony_ci
228361847f8eSopenharmony_ci    /**
228461847f8eSopenharmony_ci     * Indicates an anniversary event.
228561847f8eSopenharmony_ci     *
228661847f8eSopenharmony_ci     * @type { number }
228761847f8eSopenharmony_ci     * @readonly
228861847f8eSopenharmony_ci     * @static
228961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
229061847f8eSopenharmony_ci     * @since 7
229161847f8eSopenharmony_ci     */
229261847f8eSopenharmony_ci    /**
229361847f8eSopenharmony_ci     * Indicates an anniversary event.
229461847f8eSopenharmony_ci     *
229561847f8eSopenharmony_ci     * @type { number }
229661847f8eSopenharmony_ci     * @readonly
229761847f8eSopenharmony_ci     * @static
229861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
229961847f8eSopenharmony_ci     * @atomicservice
230061847f8eSopenharmony_ci     * @since 11
230161847f8eSopenharmony_ci     */
230261847f8eSopenharmony_ci    static readonly EVENT_ANNIVERSARY: 1
230361847f8eSopenharmony_ci
230461847f8eSopenharmony_ci    /**
230561847f8eSopenharmony_ci     * Indicates an event of the OTHER type.
230661847f8eSopenharmony_ci     *
230761847f8eSopenharmony_ci     * @type { number }
230861847f8eSopenharmony_ci     * @readonly
230961847f8eSopenharmony_ci     * @static
231061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
231161847f8eSopenharmony_ci     * @since 7
231261847f8eSopenharmony_ci     */
231361847f8eSopenharmony_ci    /**
231461847f8eSopenharmony_ci     * Indicates an event of the OTHER type.
231561847f8eSopenharmony_ci     *
231661847f8eSopenharmony_ci     * @type { number }
231761847f8eSopenharmony_ci     * @readonly
231861847f8eSopenharmony_ci     * @static
231961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
232061847f8eSopenharmony_ci     * @atomicservice
232161847f8eSopenharmony_ci     * @since 11
232261847f8eSopenharmony_ci     */
232361847f8eSopenharmony_ci    static readonly EVENT_OTHER: 2
232461847f8eSopenharmony_ci
232561847f8eSopenharmony_ci    /**
232661847f8eSopenharmony_ci     * Indicates an birthday event.
232761847f8eSopenharmony_ci     *
232861847f8eSopenharmony_ci     * @type { number }
232961847f8eSopenharmony_ci     * @readonly
233061847f8eSopenharmony_ci     * @static
233161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
233261847f8eSopenharmony_ci     * @since 7
233361847f8eSopenharmony_ci     */
233461847f8eSopenharmony_ci    /**
233561847f8eSopenharmony_ci     * Indicates an birthday event.
233661847f8eSopenharmony_ci     *
233761847f8eSopenharmony_ci     * @type { number }
233861847f8eSopenharmony_ci     * @readonly
233961847f8eSopenharmony_ci     * @static
234061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
234161847f8eSopenharmony_ci     * @atomicservice
234261847f8eSopenharmony_ci     * @since 11
234361847f8eSopenharmony_ci     */
234461847f8eSopenharmony_ci    static readonly EVENT_BIRTHDAY: 3
234561847f8eSopenharmony_ci
234661847f8eSopenharmony_ci    /**
234761847f8eSopenharmony_ci     * Indicates an invalid label ID.
234861847f8eSopenharmony_ci     *
234961847f8eSopenharmony_ci     * @type { number }
235061847f8eSopenharmony_ci     * @readonly
235161847f8eSopenharmony_ci     * @static
235261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
235361847f8eSopenharmony_ci     * @since 7
235461847f8eSopenharmony_ci     */
235561847f8eSopenharmony_ci    /**
235661847f8eSopenharmony_ci     * Indicates an invalid label ID.
235761847f8eSopenharmony_ci     *
235861847f8eSopenharmony_ci     * @type { number }
235961847f8eSopenharmony_ci     * @readonly
236061847f8eSopenharmony_ci     * @static
236161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
236261847f8eSopenharmony_ci     * @atomicservice
236361847f8eSopenharmony_ci     * @since 11
236461847f8eSopenharmony_ci     */
236561847f8eSopenharmony_ci    static readonly INVALID_LABEL_ID: -1
236661847f8eSopenharmony_ci
236761847f8eSopenharmony_ci    /**
236861847f8eSopenharmony_ci     * Indicates the event date.
236961847f8eSopenharmony_ci     *
237061847f8eSopenharmony_ci     * @type { string }
237161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
237261847f8eSopenharmony_ci     * @since 7
237361847f8eSopenharmony_ci     */
237461847f8eSopenharmony_ci    /**
237561847f8eSopenharmony_ci     * Indicates the event date.
237661847f8eSopenharmony_ci     *
237761847f8eSopenharmony_ci     * @type { string }
237861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
237961847f8eSopenharmony_ci     * @atomicservice
238061847f8eSopenharmony_ci     * @since 11
238161847f8eSopenharmony_ci     */
238261847f8eSopenharmony_ci    eventDate: string
238361847f8eSopenharmony_ci
238461847f8eSopenharmony_ci    /**
238561847f8eSopenharmony_ci     * Indicates the label name of an attribute.
238661847f8eSopenharmony_ci     *
238761847f8eSopenharmony_ci     * @type { ?string }
238861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
238961847f8eSopenharmony_ci     * @since 7
239061847f8eSopenharmony_ci     */
239161847f8eSopenharmony_ci    /**
239261847f8eSopenharmony_ci     * Indicates the label name of an attribute.
239361847f8eSopenharmony_ci     *
239461847f8eSopenharmony_ci     * @type { ?string }
239561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
239661847f8eSopenharmony_ci     * @atomicservice
239761847f8eSopenharmony_ci     * @since 11
239861847f8eSopenharmony_ci     */
239961847f8eSopenharmony_ci    labelName?: string
240061847f8eSopenharmony_ci
240161847f8eSopenharmony_ci    /**
240261847f8eSopenharmony_ci     * Indicates the label id.
240361847f8eSopenharmony_ci     *
240461847f8eSopenharmony_ci     * @type { ?number }
240561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
240661847f8eSopenharmony_ci     * @since 7
240761847f8eSopenharmony_ci     */
240861847f8eSopenharmony_ci    /**
240961847f8eSopenharmony_ci     * Indicates the label id.
241061847f8eSopenharmony_ci     *
241161847f8eSopenharmony_ci     * @type { ?number }
241261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
241361847f8eSopenharmony_ci     * @atomicservice
241461847f8eSopenharmony_ci     * @since 11
241561847f8eSopenharmony_ci     */
241661847f8eSopenharmony_ci    labelId?: number
241761847f8eSopenharmony_ci  }
241861847f8eSopenharmony_ci
241961847f8eSopenharmony_ci  /**
242061847f8eSopenharmony_ci   * Provides methods for group information
242161847f8eSopenharmony_ci   *
242261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
242361847f8eSopenharmony_ci   * @since 7
242461847f8eSopenharmony_ci   */
242561847f8eSopenharmony_ci  /**
242661847f8eSopenharmony_ci   * Provides methods for group information
242761847f8eSopenharmony_ci   *
242861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
242961847f8eSopenharmony_ci   * @atomicservice
243061847f8eSopenharmony_ci   * @since 11
243161847f8eSopenharmony_ci   */
243261847f8eSopenharmony_ci  class Group {
243361847f8eSopenharmony_ci    /**
243461847f8eSopenharmony_ci     * Indicates the contact group ID.
243561847f8eSopenharmony_ci     *
243661847f8eSopenharmony_ci     * @type { ?number }
243761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
243861847f8eSopenharmony_ci     * @since 7
243961847f8eSopenharmony_ci     */
244061847f8eSopenharmony_ci    /**
244161847f8eSopenharmony_ci     * Indicates the contact group ID.
244261847f8eSopenharmony_ci     *
244361847f8eSopenharmony_ci     * @type { ?number }
244461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
244561847f8eSopenharmony_ci     * @atomicservice
244661847f8eSopenharmony_ci     * @since 11
244761847f8eSopenharmony_ci     */
244861847f8eSopenharmony_ci    groupId?: number
244961847f8eSopenharmony_ci
245061847f8eSopenharmony_ci    /**
245161847f8eSopenharmony_ci     * Indicates the contact group title.
245261847f8eSopenharmony_ci     *
245361847f8eSopenharmony_ci     * @type { string }
245461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
245561847f8eSopenharmony_ci     * @since 7
245661847f8eSopenharmony_ci     */
245761847f8eSopenharmony_ci    /**
245861847f8eSopenharmony_ci     * Indicates the contact group title.
245961847f8eSopenharmony_ci     *
246061847f8eSopenharmony_ci     * @type { string }
246161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
246261847f8eSopenharmony_ci     * @atomicservice
246361847f8eSopenharmony_ci     * @since 11
246461847f8eSopenharmony_ci     */
246561847f8eSopenharmony_ci    title: string
246661847f8eSopenharmony_ci  }
246761847f8eSopenharmony_ci
246861847f8eSopenharmony_ci  /**
246961847f8eSopenharmony_ci   * Provides methods for holder information
247061847f8eSopenharmony_ci   *
247161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
247261847f8eSopenharmony_ci   * @since 7
247361847f8eSopenharmony_ci   */
247461847f8eSopenharmony_ci  class Holder {
247561847f8eSopenharmony_ci    /**
247661847f8eSopenharmony_ci     * Indicates the bundle name of a contact holder.
247761847f8eSopenharmony_ci     *
247861847f8eSopenharmony_ci     * @type { string }
247961847f8eSopenharmony_ci     * @readonly
248061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
248161847f8eSopenharmony_ci     * @since 7
248261847f8eSopenharmony_ci     */
248361847f8eSopenharmony_ci    readonly bundleName: string
248461847f8eSopenharmony_ci
248561847f8eSopenharmony_ci    /**
248661847f8eSopenharmony_ci     * Indicates the displayed name of a contact holder.
248761847f8eSopenharmony_ci     *
248861847f8eSopenharmony_ci     * @type { ?string }
248961847f8eSopenharmony_ci     * @readonly
249061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
249161847f8eSopenharmony_ci     * @since 7
249261847f8eSopenharmony_ci     */
249361847f8eSopenharmony_ci    readonly displayName?: string
249461847f8eSopenharmony_ci
249561847f8eSopenharmony_ci    /**
249661847f8eSopenharmony_ci     * Indicates the holder ID.
249761847f8eSopenharmony_ci     *
249861847f8eSopenharmony_ci     * @type { ?number }
249961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
250061847f8eSopenharmony_ci     * @since 7
250161847f8eSopenharmony_ci     */
250261847f8eSopenharmony_ci    holderId?: number
250361847f8eSopenharmony_ci  }
250461847f8eSopenharmony_ci
250561847f8eSopenharmony_ci  /**
250661847f8eSopenharmony_ci   * Provides methods for ImAddress information
250761847f8eSopenharmony_ci   *
250861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
250961847f8eSopenharmony_ci   * @since 7
251061847f8eSopenharmony_ci   */
251161847f8eSopenharmony_ci  /**
251261847f8eSopenharmony_ci   * Provides methods for ImAddress information
251361847f8eSopenharmony_ci   *
251461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
251561847f8eSopenharmony_ci   * @atomicservice
251661847f8eSopenharmony_ci   * @since 11
251761847f8eSopenharmony_ci   */
251861847f8eSopenharmony_ci  class ImAddress {
251961847f8eSopenharmony_ci    /**
252061847f8eSopenharmony_ci     * Indicates a custom label.
252161847f8eSopenharmony_ci     *
252261847f8eSopenharmony_ci     * @type { number }
252361847f8eSopenharmony_ci     * @readonly
252461847f8eSopenharmony_ci     * @static
252561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
252661847f8eSopenharmony_ci     * @since 7
252761847f8eSopenharmony_ci     */
252861847f8eSopenharmony_ci    /**
252961847f8eSopenharmony_ci     * Indicates a custom label.
253061847f8eSopenharmony_ci     *
253161847f8eSopenharmony_ci     * @type { number }
253261847f8eSopenharmony_ci     * @readonly
253361847f8eSopenharmony_ci     * @static
253461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
253561847f8eSopenharmony_ci     * @atomicservice
253661847f8eSopenharmony_ci     * @since 11
253761847f8eSopenharmony_ci     */
253861847f8eSopenharmony_ci    static readonly CUSTOM_LABEL: -1
253961847f8eSopenharmony_ci
254061847f8eSopenharmony_ci    /**
254161847f8eSopenharmony_ci     * Indicates an AIM instant message.
254261847f8eSopenharmony_ci     *
254361847f8eSopenharmony_ci     * @type { number }
254461847f8eSopenharmony_ci     * @readonly
254561847f8eSopenharmony_ci     * @static
254661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
254761847f8eSopenharmony_ci     * @since 7
254861847f8eSopenharmony_ci     */
254961847f8eSopenharmony_ci    /**
255061847f8eSopenharmony_ci     * Indicates an AIM instant message.
255161847f8eSopenharmony_ci     *
255261847f8eSopenharmony_ci     * @type { number }
255361847f8eSopenharmony_ci     * @readonly
255461847f8eSopenharmony_ci     * @static
255561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
255661847f8eSopenharmony_ci     * @atomicservice
255761847f8eSopenharmony_ci     * @since 11
255861847f8eSopenharmony_ci     */
255961847f8eSopenharmony_ci    static readonly IM_AIM: 0
256061847f8eSopenharmony_ci
256161847f8eSopenharmony_ci    /**
256261847f8eSopenharmony_ci     * Indicates a Windows Live instant message.
256361847f8eSopenharmony_ci     *
256461847f8eSopenharmony_ci     * @type { number }
256561847f8eSopenharmony_ci     * @readonly
256661847f8eSopenharmony_ci     * @static
256761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
256861847f8eSopenharmony_ci     * @since 7
256961847f8eSopenharmony_ci     */
257061847f8eSopenharmony_ci    /**
257161847f8eSopenharmony_ci     * Indicates a Windows Live instant message.
257261847f8eSopenharmony_ci     *
257361847f8eSopenharmony_ci     * @type { number }
257461847f8eSopenharmony_ci     * @readonly
257561847f8eSopenharmony_ci     * @static
257661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
257761847f8eSopenharmony_ci     * @atomicservice
257861847f8eSopenharmony_ci     * @since 11
257961847f8eSopenharmony_ci     */
258061847f8eSopenharmony_ci    static readonly IM_MSN: 1
258161847f8eSopenharmony_ci
258261847f8eSopenharmony_ci    /**
258361847f8eSopenharmony_ci     * Indicates a Yahoo instant message.
258461847f8eSopenharmony_ci     *
258561847f8eSopenharmony_ci     * @type { number }
258661847f8eSopenharmony_ci     * @readonly
258761847f8eSopenharmony_ci     * @static
258861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
258961847f8eSopenharmony_ci     * @since 7
259061847f8eSopenharmony_ci     */
259161847f8eSopenharmony_ci    /**
259261847f8eSopenharmony_ci     * Indicates a Yahoo instant message.
259361847f8eSopenharmony_ci     *
259461847f8eSopenharmony_ci     * @type { number }
259561847f8eSopenharmony_ci     * @readonly
259661847f8eSopenharmony_ci     * @static
259761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
259861847f8eSopenharmony_ci     * @atomicservice
259961847f8eSopenharmony_ci     * @since 11
260061847f8eSopenharmony_ci     */
260161847f8eSopenharmony_ci    static readonly IM_YAHOO: 2
260261847f8eSopenharmony_ci
260361847f8eSopenharmony_ci    /**
260461847f8eSopenharmony_ci     * Indicates a Skype instant message.
260561847f8eSopenharmony_ci     *
260661847f8eSopenharmony_ci     * @type { number }
260761847f8eSopenharmony_ci     * @readonly
260861847f8eSopenharmony_ci     * @static
260961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
261061847f8eSopenharmony_ci     * @since 7
261161847f8eSopenharmony_ci     */
261261847f8eSopenharmony_ci    /**
261361847f8eSopenharmony_ci     * Indicates a Skype instant message.
261461847f8eSopenharmony_ci     *
261561847f8eSopenharmony_ci     * @type { number }
261661847f8eSopenharmony_ci     * @readonly
261761847f8eSopenharmony_ci     * @static
261861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
261961847f8eSopenharmony_ci     * @atomicservice
262061847f8eSopenharmony_ci     * @since 11
262161847f8eSopenharmony_ci     */
262261847f8eSopenharmony_ci    static readonly IM_SKYPE: 3
262361847f8eSopenharmony_ci
262461847f8eSopenharmony_ci    /**
262561847f8eSopenharmony_ci     * Indicates a QQ instant message.
262661847f8eSopenharmony_ci     *
262761847f8eSopenharmony_ci     * @type { number }
262861847f8eSopenharmony_ci     * @readonly
262961847f8eSopenharmony_ci     * @static
263061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
263161847f8eSopenharmony_ci     * @since 7
263261847f8eSopenharmony_ci     */
263361847f8eSopenharmony_ci    /**
263461847f8eSopenharmony_ci     * Indicates a QQ instant message.
263561847f8eSopenharmony_ci     *
263661847f8eSopenharmony_ci     * @type { number }
263761847f8eSopenharmony_ci     * @readonly
263861847f8eSopenharmony_ci     * @static
263961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
264061847f8eSopenharmony_ci     * @atomicservice
264161847f8eSopenharmony_ci     * @since 11
264261847f8eSopenharmony_ci     */
264361847f8eSopenharmony_ci    static readonly IM_QQ: 4
264461847f8eSopenharmony_ci
264561847f8eSopenharmony_ci    /**
264661847f8eSopenharmony_ci     * Indicates an ICQ instant message.
264761847f8eSopenharmony_ci     *
264861847f8eSopenharmony_ci     * @type { number }
264961847f8eSopenharmony_ci     * @readonly
265061847f8eSopenharmony_ci     * @static
265161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
265261847f8eSopenharmony_ci     * @since 7
265361847f8eSopenharmony_ci     */
265461847f8eSopenharmony_ci    /**
265561847f8eSopenharmony_ci     * Indicates an ICQ instant message.
265661847f8eSopenharmony_ci     *
265761847f8eSopenharmony_ci     * @type { number }
265861847f8eSopenharmony_ci     * @readonly
265961847f8eSopenharmony_ci     * @static
266061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
266161847f8eSopenharmony_ci     * @atomicservice
266261847f8eSopenharmony_ci     * @since 11
266361847f8eSopenharmony_ci     */
266461847f8eSopenharmony_ci    static readonly IM_ICQ: 6
266561847f8eSopenharmony_ci
266661847f8eSopenharmony_ci    /**
266761847f8eSopenharmony_ci     * Indicates a Jabber instant message.
266861847f8eSopenharmony_ci     *
266961847f8eSopenharmony_ci     * @type { number }
267061847f8eSopenharmony_ci     * @readonly
267161847f8eSopenharmony_ci     * @static
267261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
267361847f8eSopenharmony_ci     * @since 7
267461847f8eSopenharmony_ci     */
267561847f8eSopenharmony_ci    /**
267661847f8eSopenharmony_ci     * Indicates a Jabber instant message.
267761847f8eSopenharmony_ci     *
267861847f8eSopenharmony_ci     * @type { number }
267961847f8eSopenharmony_ci     * @readonly
268061847f8eSopenharmony_ci     * @static
268161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
268261847f8eSopenharmony_ci     * @atomicservice
268361847f8eSopenharmony_ci     * @since 11
268461847f8eSopenharmony_ci     */
268561847f8eSopenharmony_ci    static readonly IM_JABBER: 7
268661847f8eSopenharmony_ci
268761847f8eSopenharmony_ci    /**
268861847f8eSopenharmony_ci     * Indicates an invalid label ID.
268961847f8eSopenharmony_ci     *
269061847f8eSopenharmony_ci     * @type { number }
269161847f8eSopenharmony_ci     * @readonly
269261847f8eSopenharmony_ci     * @static
269361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
269461847f8eSopenharmony_ci     * @since 7
269561847f8eSopenharmony_ci     */
269661847f8eSopenharmony_ci    /**
269761847f8eSopenharmony_ci     * Indicates an invalid label ID.
269861847f8eSopenharmony_ci     *
269961847f8eSopenharmony_ci     * @type { number }
270061847f8eSopenharmony_ci     * @readonly
270161847f8eSopenharmony_ci     * @static
270261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
270361847f8eSopenharmony_ci     * @atomicservice
270461847f8eSopenharmony_ci     * @since 11
270561847f8eSopenharmony_ci     */
270661847f8eSopenharmony_ci    static readonly INVALID_LABEL_ID: -2
270761847f8eSopenharmony_ci
270861847f8eSopenharmony_ci    /**
270961847f8eSopenharmony_ci     * Indicates the IM address.
271061847f8eSopenharmony_ci     *
271161847f8eSopenharmony_ci     * @type { string }
271261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
271361847f8eSopenharmony_ci     * @since 7
271461847f8eSopenharmony_ci     */
271561847f8eSopenharmony_ci    /**
271661847f8eSopenharmony_ci     * Indicates the IM address.
271761847f8eSopenharmony_ci     *
271861847f8eSopenharmony_ci     * @type { string }
271961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
272061847f8eSopenharmony_ci     * @atomicservice
272161847f8eSopenharmony_ci     * @since 11
272261847f8eSopenharmony_ci     */
272361847f8eSopenharmony_ci    imAddress: string
272461847f8eSopenharmony_ci
272561847f8eSopenharmony_ci    /**
272661847f8eSopenharmony_ci     * Indicates the label name of an attribute.
272761847f8eSopenharmony_ci     *
272861847f8eSopenharmony_ci     * @type { ?string }
272961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
273061847f8eSopenharmony_ci     * @since 7
273161847f8eSopenharmony_ci     */
273261847f8eSopenharmony_ci    /**
273361847f8eSopenharmony_ci     * Indicates the label name of an attribute.
273461847f8eSopenharmony_ci     *
273561847f8eSopenharmony_ci     * @type { ?string }
273661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
273761847f8eSopenharmony_ci     * @atomicservice
273861847f8eSopenharmony_ci     * @since 11
273961847f8eSopenharmony_ci     */
274061847f8eSopenharmony_ci    labelName?: string
274161847f8eSopenharmony_ci
274261847f8eSopenharmony_ci    /**
274361847f8eSopenharmony_ci     * Indicates the label id.
274461847f8eSopenharmony_ci     *
274561847f8eSopenharmony_ci     * @type { ?number }
274661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
274761847f8eSopenharmony_ci     * @since 7
274861847f8eSopenharmony_ci     */
274961847f8eSopenharmony_ci    /**
275061847f8eSopenharmony_ci     * Indicates the label id.
275161847f8eSopenharmony_ci     *
275261847f8eSopenharmony_ci     * @type { ?number }
275361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
275461847f8eSopenharmony_ci     * @atomicservice
275561847f8eSopenharmony_ci     * @since 11
275661847f8eSopenharmony_ci     */
275761847f8eSopenharmony_ci    labelId?: number
275861847f8eSopenharmony_ci  }
275961847f8eSopenharmony_ci
276061847f8eSopenharmony_ci  /**
276161847f8eSopenharmony_ci   * Provides methods for name information
276261847f8eSopenharmony_ci   *
276361847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
276461847f8eSopenharmony_ci   * @since 7
276561847f8eSopenharmony_ci   */
276661847f8eSopenharmony_ci  /**
276761847f8eSopenharmony_ci   * Provides methods for name information
276861847f8eSopenharmony_ci   *
276961847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
277061847f8eSopenharmony_ci   * @atomicservice
277161847f8eSopenharmony_ci   * @since 11
277261847f8eSopenharmony_ci   */
277361847f8eSopenharmony_ci  class Name {
277461847f8eSopenharmony_ci    /**
277561847f8eSopenharmony_ci     * Indicates the family name of the contact.
277661847f8eSopenharmony_ci     *
277761847f8eSopenharmony_ci     * @type { ?string }
277861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
277961847f8eSopenharmony_ci     * @since 7
278061847f8eSopenharmony_ci     */
278161847f8eSopenharmony_ci    /**
278261847f8eSopenharmony_ci     * Indicates the family name of the contact.
278361847f8eSopenharmony_ci     *
278461847f8eSopenharmony_ci     * @type { ?string }
278561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
278661847f8eSopenharmony_ci     * @atomicservice
278761847f8eSopenharmony_ci     * @since 11
278861847f8eSopenharmony_ci     */
278961847f8eSopenharmony_ci    familyName?: string
279061847f8eSopenharmony_ci
279161847f8eSopenharmony_ci    /**
279261847f8eSopenharmony_ci     * Indicates the phonetic family name of the contact.
279361847f8eSopenharmony_ci     *
279461847f8eSopenharmony_ci     * @type { ?string }
279561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
279661847f8eSopenharmony_ci     * @since 7
279761847f8eSopenharmony_ci     */
279861847f8eSopenharmony_ci    /**
279961847f8eSopenharmony_ci     * Indicates the phonetic family name of the contact.
280061847f8eSopenharmony_ci     *
280161847f8eSopenharmony_ci     * @type { ?string }
280261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
280361847f8eSopenharmony_ci     * @atomicservice
280461847f8eSopenharmony_ci     * @since 11
280561847f8eSopenharmony_ci     */
280661847f8eSopenharmony_ci    familyNamePhonetic?: string
280761847f8eSopenharmony_ci
280861847f8eSopenharmony_ci    /**
280961847f8eSopenharmony_ci     * Indicates the full name of the contact.
281061847f8eSopenharmony_ci     *
281161847f8eSopenharmony_ci     * @type { string }
281261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
281361847f8eSopenharmony_ci     * @since 7
281461847f8eSopenharmony_ci     */
281561847f8eSopenharmony_ci    /**
281661847f8eSopenharmony_ci     * Indicates the full name of the contact.
281761847f8eSopenharmony_ci     *
281861847f8eSopenharmony_ci     * @type { string }
281961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
282061847f8eSopenharmony_ci     * @atomicservice
282161847f8eSopenharmony_ci     * @since 11
282261847f8eSopenharmony_ci     */
282361847f8eSopenharmony_ci    fullName: string
282461847f8eSopenharmony_ci
282561847f8eSopenharmony_ci    /**
282661847f8eSopenharmony_ci     * Indicates the given name of the contact.
282761847f8eSopenharmony_ci     *
282861847f8eSopenharmony_ci     * @type { ?string }
282961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
283061847f8eSopenharmony_ci     * @since 7
283161847f8eSopenharmony_ci     */
283261847f8eSopenharmony_ci    /**
283361847f8eSopenharmony_ci     * Indicates the given name of the contact.
283461847f8eSopenharmony_ci     *
283561847f8eSopenharmony_ci     * @type { ?string }
283661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
283761847f8eSopenharmony_ci     * @atomicservice
283861847f8eSopenharmony_ci     * @since 11
283961847f8eSopenharmony_ci     */
284061847f8eSopenharmony_ci    givenName?: string
284161847f8eSopenharmony_ci
284261847f8eSopenharmony_ci    /**
284361847f8eSopenharmony_ci     * Indicates the phonetic given name of the contact.
284461847f8eSopenharmony_ci     *
284561847f8eSopenharmony_ci     * @type { ?string }
284661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
284761847f8eSopenharmony_ci     * @since 7
284861847f8eSopenharmony_ci     */
284961847f8eSopenharmony_ci    /**
285061847f8eSopenharmony_ci     * Indicates the phonetic given name of the contact.
285161847f8eSopenharmony_ci     *
285261847f8eSopenharmony_ci     * @type { ?string }
285361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
285461847f8eSopenharmony_ci     * @atomicservice
285561847f8eSopenharmony_ci     * @since 11
285661847f8eSopenharmony_ci     */
285761847f8eSopenharmony_ci    givenNamePhonetic?: string
285861847f8eSopenharmony_ci
285961847f8eSopenharmony_ci    /**
286061847f8eSopenharmony_ci     * Indicates the middle name of the contact.
286161847f8eSopenharmony_ci     *
286261847f8eSopenharmony_ci     * @type { ?string }
286361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
286461847f8eSopenharmony_ci     * @since 7
286561847f8eSopenharmony_ci     */
286661847f8eSopenharmony_ci    /**
286761847f8eSopenharmony_ci     * Indicates the middle name of the contact.
286861847f8eSopenharmony_ci     *
286961847f8eSopenharmony_ci     * @type { ?string }
287061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
287161847f8eSopenharmony_ci     * @atomicservice
287261847f8eSopenharmony_ci     * @since 11
287361847f8eSopenharmony_ci     */
287461847f8eSopenharmony_ci    middleName?: string
287561847f8eSopenharmony_ci
287661847f8eSopenharmony_ci    /**
287761847f8eSopenharmony_ci     * Indicates the phonetic middle name of the contact.
287861847f8eSopenharmony_ci     *
287961847f8eSopenharmony_ci     * @type { ?string }
288061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
288161847f8eSopenharmony_ci     * @since 7
288261847f8eSopenharmony_ci     */
288361847f8eSopenharmony_ci    /**
288461847f8eSopenharmony_ci     * Indicates the phonetic middle name of the contact.
288561847f8eSopenharmony_ci     *
288661847f8eSopenharmony_ci     * @type { ?string }
288761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
288861847f8eSopenharmony_ci     * @atomicservice
288961847f8eSopenharmony_ci     * @since 11
289061847f8eSopenharmony_ci     */
289161847f8eSopenharmony_ci    middleNamePhonetic?: string
289261847f8eSopenharmony_ci
289361847f8eSopenharmony_ci    /**
289461847f8eSopenharmony_ci     * Indicates the prefix of the contact name.
289561847f8eSopenharmony_ci     *
289661847f8eSopenharmony_ci     * @type { ?string }
289761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
289861847f8eSopenharmony_ci     * @since 7
289961847f8eSopenharmony_ci     */
290061847f8eSopenharmony_ci    /**
290161847f8eSopenharmony_ci     * Indicates the prefix of the contact name.
290261847f8eSopenharmony_ci     *
290361847f8eSopenharmony_ci     * @type { ?string }
290461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
290561847f8eSopenharmony_ci     * @atomicservice
290661847f8eSopenharmony_ci     * @since 11
290761847f8eSopenharmony_ci     */
290861847f8eSopenharmony_ci    namePrefix?: string
290961847f8eSopenharmony_ci
291061847f8eSopenharmony_ci    /**
291161847f8eSopenharmony_ci     * Indicates the suffix of this contact name.
291261847f8eSopenharmony_ci     *
291361847f8eSopenharmony_ci     * @type { ?string }
291461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
291561847f8eSopenharmony_ci     * @since 7
291661847f8eSopenharmony_ci     */
291761847f8eSopenharmony_ci    /**
291861847f8eSopenharmony_ci     * Indicates the suffix of this contact name.
291961847f8eSopenharmony_ci     *
292061847f8eSopenharmony_ci     * @type { ?string }
292161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
292261847f8eSopenharmony_ci     * @atomicservice
292361847f8eSopenharmony_ci     * @since 11
292461847f8eSopenharmony_ci     */
292561847f8eSopenharmony_ci    nameSuffix?: string
292661847f8eSopenharmony_ci  }
292761847f8eSopenharmony_ci
292861847f8eSopenharmony_ci  /**
292961847f8eSopenharmony_ci   * Provides methods for nick name information
293061847f8eSopenharmony_ci   *
293161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
293261847f8eSopenharmony_ci   * @since 7
293361847f8eSopenharmony_ci   */
293461847f8eSopenharmony_ci  /**
293561847f8eSopenharmony_ci   * Provides methods for nick name information
293661847f8eSopenharmony_ci   *
293761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
293861847f8eSopenharmony_ci   * @atomicservice
293961847f8eSopenharmony_ci   * @since 11
294061847f8eSopenharmony_ci   */
294161847f8eSopenharmony_ci  class NickName {
294261847f8eSopenharmony_ci    /**
294361847f8eSopenharmony_ci     * Indicates the nickname of the contact.
294461847f8eSopenharmony_ci     *
294561847f8eSopenharmony_ci     * @type { string }
294661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
294761847f8eSopenharmony_ci     * @since 7
294861847f8eSopenharmony_ci     */
294961847f8eSopenharmony_ci    /**
295061847f8eSopenharmony_ci     * Indicates the nickname of the contact.
295161847f8eSopenharmony_ci     *
295261847f8eSopenharmony_ci     * @type { string }
295361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
295461847f8eSopenharmony_ci     * @atomicservice
295561847f8eSopenharmony_ci     * @since 11
295661847f8eSopenharmony_ci     */
295761847f8eSopenharmony_ci    nickName: string
295861847f8eSopenharmony_ci  }
295961847f8eSopenharmony_ci
296061847f8eSopenharmony_ci  /**
296161847f8eSopenharmony_ci   * Provides methods for note information
296261847f8eSopenharmony_ci   *
296361847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
296461847f8eSopenharmony_ci   * @since 7
296561847f8eSopenharmony_ci   */
296661847f8eSopenharmony_ci  /**
296761847f8eSopenharmony_ci   * Provides methods for note information
296861847f8eSopenharmony_ci   *
296961847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
297061847f8eSopenharmony_ci   * @atomicservice
297161847f8eSopenharmony_ci   * @since 11
297261847f8eSopenharmony_ci   */
297361847f8eSopenharmony_ci  class Note {
297461847f8eSopenharmony_ci    /**
297561847f8eSopenharmony_ci     * Indicates the note content.
297661847f8eSopenharmony_ci     *
297761847f8eSopenharmony_ci     * @type { string }
297861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
297961847f8eSopenharmony_ci     * @since 7
298061847f8eSopenharmony_ci     */
298161847f8eSopenharmony_ci    /**
298261847f8eSopenharmony_ci     * Indicates the note content.
298361847f8eSopenharmony_ci     *
298461847f8eSopenharmony_ci     * @type { string }
298561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
298661847f8eSopenharmony_ci     * @atomicservice
298761847f8eSopenharmony_ci     * @since 11
298861847f8eSopenharmony_ci     */
298961847f8eSopenharmony_ci    noteContent: string
299061847f8eSopenharmony_ci  }
299161847f8eSopenharmony_ci
299261847f8eSopenharmony_ci  /**
299361847f8eSopenharmony_ci   * Provides methods for organization information
299461847f8eSopenharmony_ci   *
299561847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
299661847f8eSopenharmony_ci   * @since 7
299761847f8eSopenharmony_ci   */
299861847f8eSopenharmony_ci  /**
299961847f8eSopenharmony_ci   * Provides methods for organization information
300061847f8eSopenharmony_ci   *
300161847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
300261847f8eSopenharmony_ci   * @atomicservice
300361847f8eSopenharmony_ci   * @since 11
300461847f8eSopenharmony_ci   */
300561847f8eSopenharmony_ci  class Organization {
300661847f8eSopenharmony_ci    /**
300761847f8eSopenharmony_ci     * Indicates the name of the organization to which the contact belongs.
300861847f8eSopenharmony_ci     *
300961847f8eSopenharmony_ci     * @type { string }
301061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
301161847f8eSopenharmony_ci     * @since 7
301261847f8eSopenharmony_ci     */
301361847f8eSopenharmony_ci    /**
301461847f8eSopenharmony_ci     * Indicates the name of the organization to which the contact belongs.
301561847f8eSopenharmony_ci     *
301661847f8eSopenharmony_ci     * @type { string }
301761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
301861847f8eSopenharmony_ci     * @atomicservice
301961847f8eSopenharmony_ci     * @since 11
302061847f8eSopenharmony_ci     */
302161847f8eSopenharmony_ci    name: string
302261847f8eSopenharmony_ci
302361847f8eSopenharmony_ci    /**
302461847f8eSopenharmony_ci     * Indicates the title of the organization.
302561847f8eSopenharmony_ci     *
302661847f8eSopenharmony_ci     * @type { ?string }
302761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
302861847f8eSopenharmony_ci     * @since 7
302961847f8eSopenharmony_ci     */
303061847f8eSopenharmony_ci    /**
303161847f8eSopenharmony_ci     * Indicates the title of the organization.
303261847f8eSopenharmony_ci     *
303361847f8eSopenharmony_ci     * @type { ?string }
303461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
303561847f8eSopenharmony_ci     * @atomicservice
303661847f8eSopenharmony_ci     * @since 11
303761847f8eSopenharmony_ci     */
303861847f8eSopenharmony_ci    title?: string
303961847f8eSopenharmony_ci  }
304061847f8eSopenharmony_ci
304161847f8eSopenharmony_ci  /**
304261847f8eSopenharmony_ci   * Provides methods for phone number information
304361847f8eSopenharmony_ci   *
304461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
304561847f8eSopenharmony_ci   * @since 7
304661847f8eSopenharmony_ci   */
304761847f8eSopenharmony_ci  /**
304861847f8eSopenharmony_ci   * Provides methods for phone number information
304961847f8eSopenharmony_ci   *
305061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
305161847f8eSopenharmony_ci   * @atomicservice
305261847f8eSopenharmony_ci   * @since 11
305361847f8eSopenharmony_ci   */
305461847f8eSopenharmony_ci  class PhoneNumber {
305561847f8eSopenharmony_ci    /**
305661847f8eSopenharmony_ci     * Indicates a custom label.
305761847f8eSopenharmony_ci     *
305861847f8eSopenharmony_ci     * @type { number }
305961847f8eSopenharmony_ci     * @readonly
306061847f8eSopenharmony_ci     * @static
306161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
306261847f8eSopenharmony_ci     * @since 7
306361847f8eSopenharmony_ci     */
306461847f8eSopenharmony_ci    /**
306561847f8eSopenharmony_ci     * Indicates a custom label.
306661847f8eSopenharmony_ci     *
306761847f8eSopenharmony_ci     * @type { number }
306861847f8eSopenharmony_ci     * @readonly
306961847f8eSopenharmony_ci     * @static
307061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
307161847f8eSopenharmony_ci     * @atomicservice
307261847f8eSopenharmony_ci     * @since 11
307361847f8eSopenharmony_ci     */
307461847f8eSopenharmony_ci    static readonly CUSTOM_LABEL: 0
307561847f8eSopenharmony_ci
307661847f8eSopenharmony_ci    /**
307761847f8eSopenharmony_ci     * Indicates a home number.
307861847f8eSopenharmony_ci     *
307961847f8eSopenharmony_ci     * @type { number }
308061847f8eSopenharmony_ci     * @readonly
308161847f8eSopenharmony_ci     * @static
308261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
308361847f8eSopenharmony_ci     * @since 7
308461847f8eSopenharmony_ci     */
308561847f8eSopenharmony_ci    /**
308661847f8eSopenharmony_ci     * Indicates a home number.
308761847f8eSopenharmony_ci     *
308861847f8eSopenharmony_ci     * @type { number }
308961847f8eSopenharmony_ci     * @readonly
309061847f8eSopenharmony_ci     * @static
309161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
309261847f8eSopenharmony_ci     * @atomicservice
309361847f8eSopenharmony_ci     * @since 11
309461847f8eSopenharmony_ci     */
309561847f8eSopenharmony_ci    static readonly NUM_HOME: 1
309661847f8eSopenharmony_ci
309761847f8eSopenharmony_ci    /**
309861847f8eSopenharmony_ci     * Indicates a mobile phone number.
309961847f8eSopenharmony_ci     *
310061847f8eSopenharmony_ci     * @type { number }
310161847f8eSopenharmony_ci     * @readonly
310261847f8eSopenharmony_ci     * @static
310361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
310461847f8eSopenharmony_ci     * @since 7
310561847f8eSopenharmony_ci     */
310661847f8eSopenharmony_ci    /**
310761847f8eSopenharmony_ci     * Indicates a mobile phone number.
310861847f8eSopenharmony_ci     *
310961847f8eSopenharmony_ci     * @type { number }
311061847f8eSopenharmony_ci     * @readonly
311161847f8eSopenharmony_ci     * @static
311261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
311361847f8eSopenharmony_ci     * @atomicservice
311461847f8eSopenharmony_ci     * @since 11
311561847f8eSopenharmony_ci     */
311661847f8eSopenharmony_ci    static readonly NUM_MOBILE: 2
311761847f8eSopenharmony_ci
311861847f8eSopenharmony_ci    /**
311961847f8eSopenharmony_ci     * Indicates a work number.
312061847f8eSopenharmony_ci     *
312161847f8eSopenharmony_ci     * @type { number }
312261847f8eSopenharmony_ci     * @readonly
312361847f8eSopenharmony_ci     * @static
312461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
312561847f8eSopenharmony_ci     * @since 7
312661847f8eSopenharmony_ci     */
312761847f8eSopenharmony_ci    /**
312861847f8eSopenharmony_ci     * Indicates a work number.
312961847f8eSopenharmony_ci     *
313061847f8eSopenharmony_ci     * @type { number }
313161847f8eSopenharmony_ci     * @readonly
313261847f8eSopenharmony_ci     * @static
313361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
313461847f8eSopenharmony_ci     * @atomicservice
313561847f8eSopenharmony_ci     * @since 11
313661847f8eSopenharmony_ci     */
313761847f8eSopenharmony_ci    static readonly NUM_WORK: 3
313861847f8eSopenharmony_ci
313961847f8eSopenharmony_ci    /**
314061847f8eSopenharmony_ci     * Indicates a work fax number.
314161847f8eSopenharmony_ci     *
314261847f8eSopenharmony_ci     * @type { number }
314361847f8eSopenharmony_ci     * @readonly
314461847f8eSopenharmony_ci     * @static
314561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
314661847f8eSopenharmony_ci     * @since 7
314761847f8eSopenharmony_ci     */
314861847f8eSopenharmony_ci    /**
314961847f8eSopenharmony_ci     * Indicates a work fax number.
315061847f8eSopenharmony_ci     *
315161847f8eSopenharmony_ci     * @type { number }
315261847f8eSopenharmony_ci     * @readonly
315361847f8eSopenharmony_ci     * @static
315461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
315561847f8eSopenharmony_ci     * @atomicservice
315661847f8eSopenharmony_ci     * @since 11
315761847f8eSopenharmony_ci     */
315861847f8eSopenharmony_ci    static readonly NUM_FAX_WORK: 4
315961847f8eSopenharmony_ci
316061847f8eSopenharmony_ci    /**
316161847f8eSopenharmony_ci     * Indicates a home fax number.
316261847f8eSopenharmony_ci     *
316361847f8eSopenharmony_ci     * @type { number }
316461847f8eSopenharmony_ci     * @readonly
316561847f8eSopenharmony_ci     * @static
316661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
316761847f8eSopenharmony_ci     * @since 7
316861847f8eSopenharmony_ci     */
316961847f8eSopenharmony_ci    /**
317061847f8eSopenharmony_ci     * Indicates a home fax number.
317161847f8eSopenharmony_ci     *
317261847f8eSopenharmony_ci     * @type { number }
317361847f8eSopenharmony_ci     * @readonly
317461847f8eSopenharmony_ci     * @static
317561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
317661847f8eSopenharmony_ci     * @atomicservice
317761847f8eSopenharmony_ci     * @since 11
317861847f8eSopenharmony_ci     */
317961847f8eSopenharmony_ci    static readonly NUM_FAX_HOME: 5
318061847f8eSopenharmony_ci
318161847f8eSopenharmony_ci    /**
318261847f8eSopenharmony_ci     * Indicates a pager number.
318361847f8eSopenharmony_ci     *
318461847f8eSopenharmony_ci     * @type { number }
318561847f8eSopenharmony_ci     * @readonly
318661847f8eSopenharmony_ci     * @static
318761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
318861847f8eSopenharmony_ci     * @since 7
318961847f8eSopenharmony_ci     */
319061847f8eSopenharmony_ci    /**
319161847f8eSopenharmony_ci     * Indicates a pager number.
319261847f8eSopenharmony_ci     *
319361847f8eSopenharmony_ci     * @type { number }
319461847f8eSopenharmony_ci     * @readonly
319561847f8eSopenharmony_ci     * @static
319661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
319761847f8eSopenharmony_ci     * @atomicservice
319861847f8eSopenharmony_ci     * @since 11
319961847f8eSopenharmony_ci     */
320061847f8eSopenharmony_ci    static readonly NUM_PAGER: 6
320161847f8eSopenharmony_ci
320261847f8eSopenharmony_ci    /**
320361847f8eSopenharmony_ci     * Indicates a number of the OTHER type.
320461847f8eSopenharmony_ci     *
320561847f8eSopenharmony_ci     * @type { number }
320661847f8eSopenharmony_ci     * @readonly
320761847f8eSopenharmony_ci     * @static
320861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
320961847f8eSopenharmony_ci     * @since 7
321061847f8eSopenharmony_ci     */
321161847f8eSopenharmony_ci    /**
321261847f8eSopenharmony_ci     * Indicates a number of the OTHER type.
321361847f8eSopenharmony_ci     *
321461847f8eSopenharmony_ci     * @type { number }
321561847f8eSopenharmony_ci     * @readonly
321661847f8eSopenharmony_ci     * @static
321761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
321861847f8eSopenharmony_ci     * @atomicservice
321961847f8eSopenharmony_ci     * @since 11
322061847f8eSopenharmony_ci     */
322161847f8eSopenharmony_ci    static readonly NUM_OTHER: 7
322261847f8eSopenharmony_ci
322361847f8eSopenharmony_ci    /**
322461847f8eSopenharmony_ci     * Indicates a callback number.
322561847f8eSopenharmony_ci     *
322661847f8eSopenharmony_ci     * @type { number }
322761847f8eSopenharmony_ci     * @readonly
322861847f8eSopenharmony_ci     * @static
322961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
323061847f8eSopenharmony_ci     * @since 7
323161847f8eSopenharmony_ci     */
323261847f8eSopenharmony_ci    /**
323361847f8eSopenharmony_ci     * Indicates a callback number.
323461847f8eSopenharmony_ci     *
323561847f8eSopenharmony_ci     * @type { number }
323661847f8eSopenharmony_ci     * @readonly
323761847f8eSopenharmony_ci     * @static
323861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
323961847f8eSopenharmony_ci     * @atomicservice
324061847f8eSopenharmony_ci     * @since 11
324161847f8eSopenharmony_ci     */
324261847f8eSopenharmony_ci    static readonly NUM_CALLBACK: 8
324361847f8eSopenharmony_ci
324461847f8eSopenharmony_ci    /**
324561847f8eSopenharmony_ci     * Indicates a car number.
324661847f8eSopenharmony_ci     *
324761847f8eSopenharmony_ci     * @type { number }
324861847f8eSopenharmony_ci     * @readonly
324961847f8eSopenharmony_ci     * @static
325061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
325161847f8eSopenharmony_ci     * @since 7
325261847f8eSopenharmony_ci     */
325361847f8eSopenharmony_ci    /**
325461847f8eSopenharmony_ci     * Indicates a car number.
325561847f8eSopenharmony_ci     *
325661847f8eSopenharmony_ci     * @type { number }
325761847f8eSopenharmony_ci     * @readonly
325861847f8eSopenharmony_ci     * @static
325961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
326061847f8eSopenharmony_ci     * @atomicservice
326161847f8eSopenharmony_ci     * @since 11
326261847f8eSopenharmony_ci     */
326361847f8eSopenharmony_ci    static readonly NUM_CAR: 9
326461847f8eSopenharmony_ci
326561847f8eSopenharmony_ci    /**
326661847f8eSopenharmony_ci     * Indicates a company director number.
326761847f8eSopenharmony_ci     *
326861847f8eSopenharmony_ci     * @type { number }
326961847f8eSopenharmony_ci     * @readonly
327061847f8eSopenharmony_ci     * @static
327161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
327261847f8eSopenharmony_ci     * @since 7
327361847f8eSopenharmony_ci     */
327461847f8eSopenharmony_ci    /**
327561847f8eSopenharmony_ci     * Indicates a company director number.
327661847f8eSopenharmony_ci     *
327761847f8eSopenharmony_ci     * @type { number }
327861847f8eSopenharmony_ci     * @readonly
327961847f8eSopenharmony_ci     * @static
328061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
328161847f8eSopenharmony_ci     * @atomicservice
328261847f8eSopenharmony_ci     * @since 11
328361847f8eSopenharmony_ci     */
328461847f8eSopenharmony_ci    static readonly NUM_COMPANY_MAIN: 10
328561847f8eSopenharmony_ci
328661847f8eSopenharmony_ci    /**
328761847f8eSopenharmony_ci     * Indicates an Integrated Services Digital Network (ISDN) number.
328861847f8eSopenharmony_ci     *
328961847f8eSopenharmony_ci     * @type { number }
329061847f8eSopenharmony_ci     * @readonly
329161847f8eSopenharmony_ci     * @static
329261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
329361847f8eSopenharmony_ci     * @since 7
329461847f8eSopenharmony_ci     */
329561847f8eSopenharmony_ci    /**
329661847f8eSopenharmony_ci     * Indicates an Integrated Services Digital Network (ISDN) number.
329761847f8eSopenharmony_ci     *
329861847f8eSopenharmony_ci     * @type { number }
329961847f8eSopenharmony_ci     * @readonly
330061847f8eSopenharmony_ci     * @static
330161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
330261847f8eSopenharmony_ci     * @atomicservice
330361847f8eSopenharmony_ci     * @since 11
330461847f8eSopenharmony_ci     */
330561847f8eSopenharmony_ci    static readonly NUM_ISDN: 11
330661847f8eSopenharmony_ci
330761847f8eSopenharmony_ci    /**
330861847f8eSopenharmony_ci     * Indicates a main number.
330961847f8eSopenharmony_ci     *
331061847f8eSopenharmony_ci     * @type { number }
331161847f8eSopenharmony_ci     * @readonly
331261847f8eSopenharmony_ci     * @static
331361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
331461847f8eSopenharmony_ci     * @since 7
331561847f8eSopenharmony_ci     */
331661847f8eSopenharmony_ci    /**
331761847f8eSopenharmony_ci     * Indicates a main number.
331861847f8eSopenharmony_ci     *
331961847f8eSopenharmony_ci     * @type { number }
332061847f8eSopenharmony_ci     * @readonly
332161847f8eSopenharmony_ci     * @static
332261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
332361847f8eSopenharmony_ci     * @atomicservice
332461847f8eSopenharmony_ci     * @since 11
332561847f8eSopenharmony_ci     */
332661847f8eSopenharmony_ci    static readonly NUM_MAIN: 12
332761847f8eSopenharmony_ci
332861847f8eSopenharmony_ci    /**
332961847f8eSopenharmony_ci     * Indicates a number of the OTHER_FAX type.
333061847f8eSopenharmony_ci     *
333161847f8eSopenharmony_ci     * @type { number }
333261847f8eSopenharmony_ci     * @readonly
333361847f8eSopenharmony_ci     * @static
333461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
333561847f8eSopenharmony_ci     * @since 7
333661847f8eSopenharmony_ci     */
333761847f8eSopenharmony_ci    /**
333861847f8eSopenharmony_ci     * Indicates a number of the OTHER_FAX type.
333961847f8eSopenharmony_ci     *
334061847f8eSopenharmony_ci     * @type { number }
334161847f8eSopenharmony_ci     * @readonly
334261847f8eSopenharmony_ci     * @static
334361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
334461847f8eSopenharmony_ci     * @atomicservice
334561847f8eSopenharmony_ci     * @since 11
334661847f8eSopenharmony_ci     */
334761847f8eSopenharmony_ci    static readonly NUM_OTHER_FAX: 13
334861847f8eSopenharmony_ci
334961847f8eSopenharmony_ci    /**
335061847f8eSopenharmony_ci     * Indicates a radio number.
335161847f8eSopenharmony_ci     *
335261847f8eSopenharmony_ci     * @type { number }
335361847f8eSopenharmony_ci     * @readonly
335461847f8eSopenharmony_ci     * @static
335561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
335661847f8eSopenharmony_ci     * @since 7
335761847f8eSopenharmony_ci     */
335861847f8eSopenharmony_ci    /**
335961847f8eSopenharmony_ci     * Indicates a radio number.
336061847f8eSopenharmony_ci     *
336161847f8eSopenharmony_ci     * @type { number }
336261847f8eSopenharmony_ci     * @readonly
336361847f8eSopenharmony_ci     * @static
336461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
336561847f8eSopenharmony_ci     * @atomicservice
336661847f8eSopenharmony_ci     * @since 11
336761847f8eSopenharmony_ci     */
336861847f8eSopenharmony_ci    static readonly NUM_RADIO: 14
336961847f8eSopenharmony_ci
337061847f8eSopenharmony_ci    /**
337161847f8eSopenharmony_ci     * Indicates a telex number.
337261847f8eSopenharmony_ci     *
337361847f8eSopenharmony_ci     * @type { number }
337461847f8eSopenharmony_ci     * @readonly
337561847f8eSopenharmony_ci     * @static
337661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
337761847f8eSopenharmony_ci     * @since 7
337861847f8eSopenharmony_ci     */
337961847f8eSopenharmony_ci    /**
338061847f8eSopenharmony_ci     * Indicates a telex number.
338161847f8eSopenharmony_ci     *
338261847f8eSopenharmony_ci     * @type { number }
338361847f8eSopenharmony_ci     * @readonly
338461847f8eSopenharmony_ci     * @static
338561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
338661847f8eSopenharmony_ci     * @atomicservice
338761847f8eSopenharmony_ci     * @since 11
338861847f8eSopenharmony_ci     */
338961847f8eSopenharmony_ci    static readonly NUM_TELEX: 15
339061847f8eSopenharmony_ci
339161847f8eSopenharmony_ci    /**
339261847f8eSopenharmony_ci     * Indicates a teletypewriter (TTY) or test-driven development (TDD) number.
339361847f8eSopenharmony_ci     *
339461847f8eSopenharmony_ci     * @type { number }
339561847f8eSopenharmony_ci     * @readonly
339661847f8eSopenharmony_ci     * @static
339761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
339861847f8eSopenharmony_ci     * @since 7
339961847f8eSopenharmony_ci     */
340061847f8eSopenharmony_ci    /**
340161847f8eSopenharmony_ci     * Indicates a teletypewriter (TTY) or test-driven development (TDD) number.
340261847f8eSopenharmony_ci     *
340361847f8eSopenharmony_ci     * @type { number }
340461847f8eSopenharmony_ci     * @readonly
340561847f8eSopenharmony_ci     * @static
340661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
340761847f8eSopenharmony_ci     * @atomicservice
340861847f8eSopenharmony_ci     * @since 11
340961847f8eSopenharmony_ci     */
341061847f8eSopenharmony_ci    static readonly NUM_TTY_TDD: 16
341161847f8eSopenharmony_ci
341261847f8eSopenharmony_ci    /**
341361847f8eSopenharmony_ci     * Indicates a work mobile phone number.
341461847f8eSopenharmony_ci     *
341561847f8eSopenharmony_ci     * @type { number }
341661847f8eSopenharmony_ci     * @readonly
341761847f8eSopenharmony_ci     * @static
341861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
341961847f8eSopenharmony_ci     * @since 7
342061847f8eSopenharmony_ci     */
342161847f8eSopenharmony_ci    /**
342261847f8eSopenharmony_ci     * Indicates a work mobile phone number.
342361847f8eSopenharmony_ci     *
342461847f8eSopenharmony_ci     * @type { number }
342561847f8eSopenharmony_ci     * @readonly
342661847f8eSopenharmony_ci     * @static
342761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
342861847f8eSopenharmony_ci     * @atomicservice
342961847f8eSopenharmony_ci     * @since 11
343061847f8eSopenharmony_ci     */
343161847f8eSopenharmony_ci    static readonly NUM_WORK_MOBILE: 17
343261847f8eSopenharmony_ci
343361847f8eSopenharmony_ci    /**
343461847f8eSopenharmony_ci     * Indicates a work pager number.
343561847f8eSopenharmony_ci     *
343661847f8eSopenharmony_ci     * @type { number }
343761847f8eSopenharmony_ci     * @readonly
343861847f8eSopenharmony_ci     * @static
343961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
344061847f8eSopenharmony_ci     * @since 7
344161847f8eSopenharmony_ci     */
344261847f8eSopenharmony_ci    /**
344361847f8eSopenharmony_ci     * Indicates a work pager number.
344461847f8eSopenharmony_ci     *
344561847f8eSopenharmony_ci     * @type { number }
344661847f8eSopenharmony_ci     * @readonly
344761847f8eSopenharmony_ci     * @static
344861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
344961847f8eSopenharmony_ci     * @atomicservice
345061847f8eSopenharmony_ci     * @since 11
345161847f8eSopenharmony_ci     */
345261847f8eSopenharmony_ci    static readonly NUM_WORK_PAGER: 18
345361847f8eSopenharmony_ci
345461847f8eSopenharmony_ci    /**
345561847f8eSopenharmony_ci     * Indicates an assistant number.
345661847f8eSopenharmony_ci     *
345761847f8eSopenharmony_ci     * @type { number }
345861847f8eSopenharmony_ci     * @readonly
345961847f8eSopenharmony_ci     * @static
346061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
346161847f8eSopenharmony_ci     * @since 7
346261847f8eSopenharmony_ci     */
346361847f8eSopenharmony_ci    /**
346461847f8eSopenharmony_ci     * Indicates an assistant number.
346561847f8eSopenharmony_ci     *
346661847f8eSopenharmony_ci     * @type { number }
346761847f8eSopenharmony_ci     * @readonly
346861847f8eSopenharmony_ci     * @static
346961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
347061847f8eSopenharmony_ci     * @atomicservice
347161847f8eSopenharmony_ci     * @since 11
347261847f8eSopenharmony_ci     */
347361847f8eSopenharmony_ci    static readonly NUM_ASSISTANT: 19
347461847f8eSopenharmony_ci
347561847f8eSopenharmony_ci    /**
347661847f8eSopenharmony_ci     * Indicates an MMS number.
347761847f8eSopenharmony_ci     *
347861847f8eSopenharmony_ci     * @type { number }
347961847f8eSopenharmony_ci     * @readonly
348061847f8eSopenharmony_ci     * @static
348161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
348261847f8eSopenharmony_ci     * @since 7
348361847f8eSopenharmony_ci     */
348461847f8eSopenharmony_ci    /**
348561847f8eSopenharmony_ci     * Indicates an MMS number.
348661847f8eSopenharmony_ci     *
348761847f8eSopenharmony_ci     * @type { number }
348861847f8eSopenharmony_ci     * @readonly
348961847f8eSopenharmony_ci     * @static
349061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
349161847f8eSopenharmony_ci     * @atomicservice
349261847f8eSopenharmony_ci     * @since 11
349361847f8eSopenharmony_ci     */
349461847f8eSopenharmony_ci    static readonly NUM_MMS: 20
349561847f8eSopenharmony_ci
349661847f8eSopenharmony_ci    /**
349761847f8eSopenharmony_ci     * Indicates an invalid label ID.
349861847f8eSopenharmony_ci     *
349961847f8eSopenharmony_ci     * @type { number }
350061847f8eSopenharmony_ci     * @readonly
350161847f8eSopenharmony_ci     * @static
350261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
350361847f8eSopenharmony_ci     * @since 7
350461847f8eSopenharmony_ci     */
350561847f8eSopenharmony_ci    /**
350661847f8eSopenharmony_ci     * Indicates an invalid label ID.
350761847f8eSopenharmony_ci     *
350861847f8eSopenharmony_ci     * @type { number }
350961847f8eSopenharmony_ci     * @readonly
351061847f8eSopenharmony_ci     * @static
351161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
351261847f8eSopenharmony_ci     * @atomicservice
351361847f8eSopenharmony_ci     * @since 11
351461847f8eSopenharmony_ci     */
351561847f8eSopenharmony_ci    static readonly INVALID_LABEL_ID: -1
351661847f8eSopenharmony_ci
351761847f8eSopenharmony_ci    /**
351861847f8eSopenharmony_ci     * Indicates the label name of an attribute.
351961847f8eSopenharmony_ci     *
352061847f8eSopenharmony_ci     * @type { ?string }
352161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
352261847f8eSopenharmony_ci     * @since 7
352361847f8eSopenharmony_ci     */
352461847f8eSopenharmony_ci    /**
352561847f8eSopenharmony_ci     * Indicates the label name of an attribute.
352661847f8eSopenharmony_ci     *
352761847f8eSopenharmony_ci     * @type { ?string }
352861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
352961847f8eSopenharmony_ci     * @atomicservice
353061847f8eSopenharmony_ci     * @since 11
353161847f8eSopenharmony_ci     */
353261847f8eSopenharmony_ci    labelName?: string
353361847f8eSopenharmony_ci
353461847f8eSopenharmony_ci    /**
353561847f8eSopenharmony_ci     * Indicates the phone number of the contact.
353661847f8eSopenharmony_ci     *
353761847f8eSopenharmony_ci     * @type { string }
353861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
353961847f8eSopenharmony_ci     * @since 7
354061847f8eSopenharmony_ci     */
354161847f8eSopenharmony_ci    /**
354261847f8eSopenharmony_ci     * Indicates the phone number of the contact.
354361847f8eSopenharmony_ci     *
354461847f8eSopenharmony_ci     * @type { string }
354561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
354661847f8eSopenharmony_ci     * @atomicservice
354761847f8eSopenharmony_ci     * @since 11
354861847f8eSopenharmony_ci     */
354961847f8eSopenharmony_ci    phoneNumber: string
355061847f8eSopenharmony_ci
355161847f8eSopenharmony_ci    /**
355261847f8eSopenharmony_ci     * Indicates the label id.
355361847f8eSopenharmony_ci     *
355461847f8eSopenharmony_ci     * @type { ?number }
355561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
355661847f8eSopenharmony_ci     * @since 7
355761847f8eSopenharmony_ci     */
355861847f8eSopenharmony_ci    /**
355961847f8eSopenharmony_ci     * Indicates the label id.
356061847f8eSopenharmony_ci     *
356161847f8eSopenharmony_ci     * @type { ?number }
356261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
356361847f8eSopenharmony_ci     * @atomicservice
356461847f8eSopenharmony_ci     * @since 11
356561847f8eSopenharmony_ci     */
356661847f8eSopenharmony_ci    labelId?: number
356761847f8eSopenharmony_ci  }
356861847f8eSopenharmony_ci
356961847f8eSopenharmony_ci  /**
357061847f8eSopenharmony_ci   * Provides methods for portrait information
357161847f8eSopenharmony_ci   *
357261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
357361847f8eSopenharmony_ci   * @since 7
357461847f8eSopenharmony_ci   */
357561847f8eSopenharmony_ci  /**
357661847f8eSopenharmony_ci   * Provides methods for portrait information
357761847f8eSopenharmony_ci   *
357861847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
357961847f8eSopenharmony_ci   * @atomicservice
358061847f8eSopenharmony_ci   * @since 11
358161847f8eSopenharmony_ci   */
358261847f8eSopenharmony_ci  class Portrait {
358361847f8eSopenharmony_ci    /**
358461847f8eSopenharmony_ci     * Indicates the uri of the contact portrait.
358561847f8eSopenharmony_ci     *
358661847f8eSopenharmony_ci     * @type { string }
358761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
358861847f8eSopenharmony_ci     * @since 7
358961847f8eSopenharmony_ci     */
359061847f8eSopenharmony_ci    /**
359161847f8eSopenharmony_ci     * Indicates the uri of the contact portrait.
359261847f8eSopenharmony_ci     *
359361847f8eSopenharmony_ci     * @type { string }
359461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
359561847f8eSopenharmony_ci     * @atomicservice
359661847f8eSopenharmony_ci     * @since 11
359761847f8eSopenharmony_ci     */
359861847f8eSopenharmony_ci    uri: string
359961847f8eSopenharmony_ci  }
360061847f8eSopenharmony_ci
360161847f8eSopenharmony_ci  /**
360261847f8eSopenharmony_ci   * Provides methods for postal address information
360361847f8eSopenharmony_ci   *
360461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
360561847f8eSopenharmony_ci   * @since 7
360661847f8eSopenharmony_ci   */
360761847f8eSopenharmony_ci  /**
360861847f8eSopenharmony_ci   * Provides methods for postal address information
360961847f8eSopenharmony_ci   *
361061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
361161847f8eSopenharmony_ci   * @atomicservice
361261847f8eSopenharmony_ci   * @since 11
361361847f8eSopenharmony_ci   */
361461847f8eSopenharmony_ci  class PostalAddress {
361561847f8eSopenharmony_ci    /**
361661847f8eSopenharmony_ci     * Indicates a custom label.
361761847f8eSopenharmony_ci     *
361861847f8eSopenharmony_ci     * @type { number }
361961847f8eSopenharmony_ci     * @readonly
362061847f8eSopenharmony_ci     * @static
362161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
362261847f8eSopenharmony_ci     * @since 7
362361847f8eSopenharmony_ci     */
362461847f8eSopenharmony_ci    /**
362561847f8eSopenharmony_ci     * Indicates a custom label.
362661847f8eSopenharmony_ci     *
362761847f8eSopenharmony_ci     * @type { number }
362861847f8eSopenharmony_ci     * @readonly
362961847f8eSopenharmony_ci     * @static
363061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
363161847f8eSopenharmony_ci     * @atomicservice
363261847f8eSopenharmony_ci     * @since 11
363361847f8eSopenharmony_ci     */
363461847f8eSopenharmony_ci    static readonly CUSTOM_LABEL: 0
363561847f8eSopenharmony_ci
363661847f8eSopenharmony_ci    /**
363761847f8eSopenharmony_ci     * Indicates a home address.
363861847f8eSopenharmony_ci     *
363961847f8eSopenharmony_ci     * @type { number }
364061847f8eSopenharmony_ci     * @readonly
364161847f8eSopenharmony_ci     * @static
364261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
364361847f8eSopenharmony_ci     * @since 7
364461847f8eSopenharmony_ci     */
364561847f8eSopenharmony_ci    /**
364661847f8eSopenharmony_ci     * Indicates a home address.
364761847f8eSopenharmony_ci     *
364861847f8eSopenharmony_ci     * @type { number }
364961847f8eSopenharmony_ci     * @readonly
365061847f8eSopenharmony_ci     * @static
365161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
365261847f8eSopenharmony_ci     * @atomicservice
365361847f8eSopenharmony_ci     * @since 11
365461847f8eSopenharmony_ci     */
365561847f8eSopenharmony_ci    static readonly ADDR_HOME: 1
365661847f8eSopenharmony_ci
365761847f8eSopenharmony_ci    /**
365861847f8eSopenharmony_ci     * Indicates a work address.
365961847f8eSopenharmony_ci     *
366061847f8eSopenharmony_ci     * @type { number }
366161847f8eSopenharmony_ci     * @readonly
366261847f8eSopenharmony_ci     * @static
366361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
366461847f8eSopenharmony_ci     * @since 7
366561847f8eSopenharmony_ci     */
366661847f8eSopenharmony_ci    /**
366761847f8eSopenharmony_ci     * Indicates a work address.
366861847f8eSopenharmony_ci     *
366961847f8eSopenharmony_ci     * @type { number }
367061847f8eSopenharmony_ci     * @readonly
367161847f8eSopenharmony_ci     * @static
367261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
367361847f8eSopenharmony_ci     * @atomicservice
367461847f8eSopenharmony_ci     * @since 11
367561847f8eSopenharmony_ci     */
367661847f8eSopenharmony_ci    static readonly ADDR_WORK: 2
367761847f8eSopenharmony_ci
367861847f8eSopenharmony_ci    /**
367961847f8eSopenharmony_ci     * Indicates an address of the OTHER type.
368061847f8eSopenharmony_ci     *
368161847f8eSopenharmony_ci     * @type { number }
368261847f8eSopenharmony_ci     * @readonly
368361847f8eSopenharmony_ci     * @static
368461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
368561847f8eSopenharmony_ci     * @since 7
368661847f8eSopenharmony_ci     */
368761847f8eSopenharmony_ci    /**
368861847f8eSopenharmony_ci     * Indicates an address of the OTHER type.
368961847f8eSopenharmony_ci     *
369061847f8eSopenharmony_ci     * @type { number }
369161847f8eSopenharmony_ci     * @readonly
369261847f8eSopenharmony_ci     * @static
369361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
369461847f8eSopenharmony_ci     * @atomicservice
369561847f8eSopenharmony_ci     * @since 11
369661847f8eSopenharmony_ci     */
369761847f8eSopenharmony_ci    static readonly ADDR_OTHER: 3
369861847f8eSopenharmony_ci
369961847f8eSopenharmony_ci    /**
370061847f8eSopenharmony_ci     * Indicates an invalid label ID.
370161847f8eSopenharmony_ci     *
370261847f8eSopenharmony_ci     * @type { number }
370361847f8eSopenharmony_ci     * @readonly
370461847f8eSopenharmony_ci     * @static
370561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
370661847f8eSopenharmony_ci     * @since 7
370761847f8eSopenharmony_ci     */
370861847f8eSopenharmony_ci    /**
370961847f8eSopenharmony_ci     * Indicates an invalid label ID.
371061847f8eSopenharmony_ci     *
371161847f8eSopenharmony_ci     * @type { number }
371261847f8eSopenharmony_ci     * @readonly
371361847f8eSopenharmony_ci     * @static
371461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
371561847f8eSopenharmony_ci     * @atomicservice
371661847f8eSopenharmony_ci     * @since 11
371761847f8eSopenharmony_ci     */
371861847f8eSopenharmony_ci    static readonly INVALID_LABEL_ID: -1
371961847f8eSopenharmony_ci
372061847f8eSopenharmony_ci    /**
372161847f8eSopenharmony_ci     * Indicates the city where this contact is located.
372261847f8eSopenharmony_ci     *
372361847f8eSopenharmony_ci     * @type { ?string }
372461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
372561847f8eSopenharmony_ci     * @since 7
372661847f8eSopenharmony_ci     */
372761847f8eSopenharmony_ci    /**
372861847f8eSopenharmony_ci     * Indicates the city where this contact is located.
372961847f8eSopenharmony_ci     *
373061847f8eSopenharmony_ci     * @type { ?string }
373161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
373261847f8eSopenharmony_ci     * @atomicservice
373361847f8eSopenharmony_ci     * @since 11
373461847f8eSopenharmony_ci     */
373561847f8eSopenharmony_ci    city?: string
373661847f8eSopenharmony_ci
373761847f8eSopenharmony_ci    /**
373861847f8eSopenharmony_ci     * Indicates the country/region where this contact is located.
373961847f8eSopenharmony_ci     *
374061847f8eSopenharmony_ci     * @type { ?string }
374161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
374261847f8eSopenharmony_ci     * @since 7
374361847f8eSopenharmony_ci     */
374461847f8eSopenharmony_ci    /**
374561847f8eSopenharmony_ci     * Indicates the country/region where this contact is located.
374661847f8eSopenharmony_ci     *
374761847f8eSopenharmony_ci     * @type { ?string }
374861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
374961847f8eSopenharmony_ci     * @atomicservice
375061847f8eSopenharmony_ci     * @since 11
375161847f8eSopenharmony_ci     */
375261847f8eSopenharmony_ci    country?: string
375361847f8eSopenharmony_ci
375461847f8eSopenharmony_ci    /**
375561847f8eSopenharmony_ci     * Indicates the label name of an attribute.
375661847f8eSopenharmony_ci     *
375761847f8eSopenharmony_ci     * @type { ?string }
375861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
375961847f8eSopenharmony_ci     * @since 7
376061847f8eSopenharmony_ci     */
376161847f8eSopenharmony_ci    /**
376261847f8eSopenharmony_ci     * Indicates the label name of an attribute.
376361847f8eSopenharmony_ci     *
376461847f8eSopenharmony_ci     * @type { ?string }
376561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
376661847f8eSopenharmony_ci     * @atomicservice
376761847f8eSopenharmony_ci     * @since 11
376861847f8eSopenharmony_ci     */
376961847f8eSopenharmony_ci    labelName?: string
377061847f8eSopenharmony_ci
377161847f8eSopenharmony_ci    /**
377261847f8eSopenharmony_ci     * Indicates the neighborhood where this contact is located.
377361847f8eSopenharmony_ci     *
377461847f8eSopenharmony_ci     * @type { ?string }
377561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
377661847f8eSopenharmony_ci     * @since 7
377761847f8eSopenharmony_ci     */
377861847f8eSopenharmony_ci    /**
377961847f8eSopenharmony_ci     * Indicates the neighborhood where this contact is located.
378061847f8eSopenharmony_ci     *
378161847f8eSopenharmony_ci     * @type { ?string }
378261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
378361847f8eSopenharmony_ci     * @atomicservice
378461847f8eSopenharmony_ci     * @since 11
378561847f8eSopenharmony_ci     */
378661847f8eSopenharmony_ci    neighborhood?: string
378761847f8eSopenharmony_ci
378861847f8eSopenharmony_ci    /**
378961847f8eSopenharmony_ci     * Indicates the post box of this contact.
379061847f8eSopenharmony_ci     *
379161847f8eSopenharmony_ci     * @type { ?string }
379261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
379361847f8eSopenharmony_ci     * @since 7
379461847f8eSopenharmony_ci     */
379561847f8eSopenharmony_ci    /**
379661847f8eSopenharmony_ci     * Indicates the post box of this contact.
379761847f8eSopenharmony_ci     *
379861847f8eSopenharmony_ci     * @type { ?string }
379961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
380061847f8eSopenharmony_ci     * @atomicservice
380161847f8eSopenharmony_ci     * @since 11
380261847f8eSopenharmony_ci     */
380361847f8eSopenharmony_ci    pobox?: string
380461847f8eSopenharmony_ci
380561847f8eSopenharmony_ci    /**
380661847f8eSopenharmony_ci     * Indicates the postal address of this contact.
380761847f8eSopenharmony_ci     *
380861847f8eSopenharmony_ci     * @type { string }
380961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
381061847f8eSopenharmony_ci     * @since 7
381161847f8eSopenharmony_ci     */
381261847f8eSopenharmony_ci    /**
381361847f8eSopenharmony_ci     * Indicates the postal address of this contact.
381461847f8eSopenharmony_ci     *
381561847f8eSopenharmony_ci     * @type { string }
381661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
381761847f8eSopenharmony_ci     * @atomicservice
381861847f8eSopenharmony_ci     * @since 11
381961847f8eSopenharmony_ci     */
382061847f8eSopenharmony_ci    postalAddress: string
382161847f8eSopenharmony_ci
382261847f8eSopenharmony_ci    /**
382361847f8eSopenharmony_ci     * Indicates the postal code of this contact.
382461847f8eSopenharmony_ci     *
382561847f8eSopenharmony_ci     * @type { ?string }
382661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
382761847f8eSopenharmony_ci     * @since 7
382861847f8eSopenharmony_ci     */
382961847f8eSopenharmony_ci    /**
383061847f8eSopenharmony_ci     * Indicates the postal code of this contact.
383161847f8eSopenharmony_ci     *
383261847f8eSopenharmony_ci     * @type { ?string }
383361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
383461847f8eSopenharmony_ci     * @atomicservice
383561847f8eSopenharmony_ci     * @since 11
383661847f8eSopenharmony_ci     */
383761847f8eSopenharmony_ci    postcode?: string
383861847f8eSopenharmony_ci
383961847f8eSopenharmony_ci    /**
384061847f8eSopenharmony_ci     * Indicates the area where this contact is located.
384161847f8eSopenharmony_ci     *
384261847f8eSopenharmony_ci     * @type { ?string }
384361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
384461847f8eSopenharmony_ci     * @since 7
384561847f8eSopenharmony_ci     */
384661847f8eSopenharmony_ci    /**
384761847f8eSopenharmony_ci     * Indicates the area where this contact is located.
384861847f8eSopenharmony_ci     *
384961847f8eSopenharmony_ci     * @type { ?string }
385061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
385161847f8eSopenharmony_ci     * @atomicservice
385261847f8eSopenharmony_ci     * @since 11
385361847f8eSopenharmony_ci     */
385461847f8eSopenharmony_ci    region?: string
385561847f8eSopenharmony_ci
385661847f8eSopenharmony_ci    /**
385761847f8eSopenharmony_ci     * Indicates the street where this contact is located.
385861847f8eSopenharmony_ci     *
385961847f8eSopenharmony_ci     * @type { ?string }
386061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
386161847f8eSopenharmony_ci     * @since 7
386261847f8eSopenharmony_ci     */
386361847f8eSopenharmony_ci    /**
386461847f8eSopenharmony_ci     * Indicates the street where this contact is located.
386561847f8eSopenharmony_ci     *
386661847f8eSopenharmony_ci     * @type { ?string }
386761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
386861847f8eSopenharmony_ci     * @atomicservice
386961847f8eSopenharmony_ci     * @since 11
387061847f8eSopenharmony_ci     */
387161847f8eSopenharmony_ci    street?: string
387261847f8eSopenharmony_ci
387361847f8eSopenharmony_ci    /**
387461847f8eSopenharmony_ci     * Indicates the label id.
387561847f8eSopenharmony_ci     *
387661847f8eSopenharmony_ci     * @type { ?number }
387761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
387861847f8eSopenharmony_ci     * @since 7
387961847f8eSopenharmony_ci     */
388061847f8eSopenharmony_ci    /**
388161847f8eSopenharmony_ci     * Indicates the label id.
388261847f8eSopenharmony_ci     *
388361847f8eSopenharmony_ci     * @type { ?number }
388461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
388561847f8eSopenharmony_ci     * @atomicservice
388661847f8eSopenharmony_ci     * @since 11
388761847f8eSopenharmony_ci     */
388861847f8eSopenharmony_ci    labelId?: number
388961847f8eSopenharmony_ci  }
389061847f8eSopenharmony_ci
389161847f8eSopenharmony_ci  /**
389261847f8eSopenharmony_ci   * Provides methods for relation information
389361847f8eSopenharmony_ci   *
389461847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
389561847f8eSopenharmony_ci   * @since 7
389661847f8eSopenharmony_ci   */
389761847f8eSopenharmony_ci  /**
389861847f8eSopenharmony_ci   * Provides methods for relation information
389961847f8eSopenharmony_ci   *
390061847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
390161847f8eSopenharmony_ci   * @atomicservice
390261847f8eSopenharmony_ci   * @since 11
390361847f8eSopenharmony_ci   */
390461847f8eSopenharmony_ci  class Relation {
390561847f8eSopenharmony_ci    /**
390661847f8eSopenharmony_ci     * Indicates custom relationship type.
390761847f8eSopenharmony_ci     *
390861847f8eSopenharmony_ci     * @type { number }
390961847f8eSopenharmony_ci     * @readonly
391061847f8eSopenharmony_ci     * @static
391161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
391261847f8eSopenharmony_ci     * @since 7
391361847f8eSopenharmony_ci     */
391461847f8eSopenharmony_ci    /**
391561847f8eSopenharmony_ci     * Indicates custom relationship type.
391661847f8eSopenharmony_ci     *
391761847f8eSopenharmony_ci     * @type { number }
391861847f8eSopenharmony_ci     * @readonly
391961847f8eSopenharmony_ci     * @static
392061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
392161847f8eSopenharmony_ci     * @atomicservice
392261847f8eSopenharmony_ci     * @since 11
392361847f8eSopenharmony_ci     */
392461847f8eSopenharmony_ci    static readonly CUSTOM_LABEL: 0
392561847f8eSopenharmony_ci
392661847f8eSopenharmony_ci    /**
392761847f8eSopenharmony_ci     * Indicates assistant relationship type.
392861847f8eSopenharmony_ci     *
392961847f8eSopenharmony_ci     * @type { number }
393061847f8eSopenharmony_ci     * @readonly
393161847f8eSopenharmony_ci     * @static
393261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
393361847f8eSopenharmony_ci     * @since 7
393461847f8eSopenharmony_ci     */
393561847f8eSopenharmony_ci    /**
393661847f8eSopenharmony_ci     * Indicates assistant relationship type.
393761847f8eSopenharmony_ci     *
393861847f8eSopenharmony_ci     * @type { number }
393961847f8eSopenharmony_ci     * @readonly
394061847f8eSopenharmony_ci     * @static
394161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
394261847f8eSopenharmony_ci     * @atomicservice
394361847f8eSopenharmony_ci     * @since 11
394461847f8eSopenharmony_ci     */
394561847f8eSopenharmony_ci    static readonly RELATION_ASSISTANT: 1
394661847f8eSopenharmony_ci
394761847f8eSopenharmony_ci    /**
394861847f8eSopenharmony_ci     * Indicates brother relationship type.
394961847f8eSopenharmony_ci     *
395061847f8eSopenharmony_ci     * @type { number }
395161847f8eSopenharmony_ci     * @readonly
395261847f8eSopenharmony_ci     * @static
395361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
395461847f8eSopenharmony_ci     * @since 7
395561847f8eSopenharmony_ci     */
395661847f8eSopenharmony_ci    /**
395761847f8eSopenharmony_ci     * Indicates brother relationship type.
395861847f8eSopenharmony_ci     *
395961847f8eSopenharmony_ci     * @type { number }
396061847f8eSopenharmony_ci     * @readonly
396161847f8eSopenharmony_ci     * @static
396261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
396361847f8eSopenharmony_ci     * @atomicservice
396461847f8eSopenharmony_ci     * @since 11
396561847f8eSopenharmony_ci     */
396661847f8eSopenharmony_ci    static readonly RELATION_BROTHER: 2
396761847f8eSopenharmony_ci
396861847f8eSopenharmony_ci    /**
396961847f8eSopenharmony_ci     * Indicates child relationship type.
397061847f8eSopenharmony_ci     *
397161847f8eSopenharmony_ci     * @type { number }
397261847f8eSopenharmony_ci     * @readonly
397361847f8eSopenharmony_ci     * @static
397461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
397561847f8eSopenharmony_ci     * @since 7
397661847f8eSopenharmony_ci     */
397761847f8eSopenharmony_ci    /**
397861847f8eSopenharmony_ci     * Indicates child relationship type.
397961847f8eSopenharmony_ci     *
398061847f8eSopenharmony_ci     * @type { number }
398161847f8eSopenharmony_ci     * @readonly
398261847f8eSopenharmony_ci     * @static
398361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
398461847f8eSopenharmony_ci     * @atomicservice
398561847f8eSopenharmony_ci     * @since 11
398661847f8eSopenharmony_ci     */
398761847f8eSopenharmony_ci    static readonly RELATION_CHILD: 3
398861847f8eSopenharmony_ci
398961847f8eSopenharmony_ci    /**
399061847f8eSopenharmony_ci     * Indicates domestic partner relationship type.
399161847f8eSopenharmony_ci     *
399261847f8eSopenharmony_ci     * @type { number }
399361847f8eSopenharmony_ci     * @readonly
399461847f8eSopenharmony_ci     * @static
399561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
399661847f8eSopenharmony_ci     * @since 7
399761847f8eSopenharmony_ci     */
399861847f8eSopenharmony_ci    /**
399961847f8eSopenharmony_ci     * Indicates domestic partner relationship type.
400061847f8eSopenharmony_ci     *
400161847f8eSopenharmony_ci     * @type { number }
400261847f8eSopenharmony_ci     * @readonly
400361847f8eSopenharmony_ci     * @static
400461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
400561847f8eSopenharmony_ci     * @atomicservice
400661847f8eSopenharmony_ci     * @since 11
400761847f8eSopenharmony_ci     */
400861847f8eSopenharmony_ci    static readonly RELATION_DOMESTIC_PARTNER: 4
400961847f8eSopenharmony_ci
401061847f8eSopenharmony_ci    /**
401161847f8eSopenharmony_ci     * Indicates father relationship type.
401261847f8eSopenharmony_ci     *
401361847f8eSopenharmony_ci     * @type { number }
401461847f8eSopenharmony_ci     * @readonly
401561847f8eSopenharmony_ci     * @static
401661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
401761847f8eSopenharmony_ci     * @since 7
401861847f8eSopenharmony_ci     */
401961847f8eSopenharmony_ci    /**
402061847f8eSopenharmony_ci     * Indicates father relationship type.
402161847f8eSopenharmony_ci     *
402261847f8eSopenharmony_ci     * @type { number }
402361847f8eSopenharmony_ci     * @readonly
402461847f8eSopenharmony_ci     * @static
402561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
402661847f8eSopenharmony_ci     * @atomicservice
402761847f8eSopenharmony_ci     * @since 11
402861847f8eSopenharmony_ci     */
402961847f8eSopenharmony_ci    static readonly RELATION_FATHER: 5
403061847f8eSopenharmony_ci
403161847f8eSopenharmony_ci    /**
403261847f8eSopenharmony_ci     * Indicates friend relationship type.
403361847f8eSopenharmony_ci     *
403461847f8eSopenharmony_ci     * @type { number }
403561847f8eSopenharmony_ci     * @readonly
403661847f8eSopenharmony_ci     * @static
403761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
403861847f8eSopenharmony_ci     * @since 7
403961847f8eSopenharmony_ci     */
404061847f8eSopenharmony_ci    /**
404161847f8eSopenharmony_ci     * Indicates friend relationship type.
404261847f8eSopenharmony_ci     *
404361847f8eSopenharmony_ci     * @type { number }
404461847f8eSopenharmony_ci     * @readonly
404561847f8eSopenharmony_ci     * @static
404661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
404761847f8eSopenharmony_ci     * @atomicservice
404861847f8eSopenharmony_ci     * @since 11
404961847f8eSopenharmony_ci     */
405061847f8eSopenharmony_ci    static readonly RELATION_FRIEND: 6
405161847f8eSopenharmony_ci
405261847f8eSopenharmony_ci    /**
405361847f8eSopenharmony_ci     * Indicates manager relationship type.
405461847f8eSopenharmony_ci     *
405561847f8eSopenharmony_ci     * @type { number }
405661847f8eSopenharmony_ci     * @readonly
405761847f8eSopenharmony_ci     * @static
405861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
405961847f8eSopenharmony_ci     * @since 7
406061847f8eSopenharmony_ci     */
406161847f8eSopenharmony_ci    /**
406261847f8eSopenharmony_ci     * Indicates manager relationship type.
406361847f8eSopenharmony_ci     *
406461847f8eSopenharmony_ci     * @type { number }
406561847f8eSopenharmony_ci     * @readonly
406661847f8eSopenharmony_ci     * @static
406761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
406861847f8eSopenharmony_ci     * @atomicservice
406961847f8eSopenharmony_ci     * @since 11
407061847f8eSopenharmony_ci     */
407161847f8eSopenharmony_ci    static readonly RELATION_MANAGER: 7
407261847f8eSopenharmony_ci
407361847f8eSopenharmony_ci    /**
407461847f8eSopenharmony_ci     * Indicates mother relationship type.
407561847f8eSopenharmony_ci     *
407661847f8eSopenharmony_ci     * @type { number }
407761847f8eSopenharmony_ci     * @readonly
407861847f8eSopenharmony_ci     * @static
407961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
408061847f8eSopenharmony_ci     * @since 7
408161847f8eSopenharmony_ci     */
408261847f8eSopenharmony_ci    /**
408361847f8eSopenharmony_ci     * Indicates mother relationship type.
408461847f8eSopenharmony_ci     *
408561847f8eSopenharmony_ci     * @type { number }
408661847f8eSopenharmony_ci     * @readonly
408761847f8eSopenharmony_ci     * @static
408861847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
408961847f8eSopenharmony_ci     * @atomicservice
409061847f8eSopenharmony_ci     * @since 11
409161847f8eSopenharmony_ci     */
409261847f8eSopenharmony_ci    static readonly RELATION_MOTHER: 8
409361847f8eSopenharmony_ci
409461847f8eSopenharmony_ci    /**
409561847f8eSopenharmony_ci     * Indicates parent relationship type.
409661847f8eSopenharmony_ci     *
409761847f8eSopenharmony_ci     * @type { number }
409861847f8eSopenharmony_ci     * @readonly
409961847f8eSopenharmony_ci     * @static
410061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
410161847f8eSopenharmony_ci     * @since 7
410261847f8eSopenharmony_ci     */
410361847f8eSopenharmony_ci    /**
410461847f8eSopenharmony_ci     * Indicates parent relationship type.
410561847f8eSopenharmony_ci     *
410661847f8eSopenharmony_ci     * @type { number }
410761847f8eSopenharmony_ci     * @readonly
410861847f8eSopenharmony_ci     * @static
410961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
411061847f8eSopenharmony_ci     * @atomicservice
411161847f8eSopenharmony_ci     * @since 11
411261847f8eSopenharmony_ci     */
411361847f8eSopenharmony_ci    static readonly RELATION_PARENT: 9
411461847f8eSopenharmony_ci
411561847f8eSopenharmony_ci    /**
411661847f8eSopenharmony_ci     * Indicates partner relationship type.
411761847f8eSopenharmony_ci     *
411861847f8eSopenharmony_ci     * @type { number }
411961847f8eSopenharmony_ci     * @readonly
412061847f8eSopenharmony_ci     * @static
412161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
412261847f8eSopenharmony_ci     * @since 7
412361847f8eSopenharmony_ci     */
412461847f8eSopenharmony_ci    /**
412561847f8eSopenharmony_ci     * Indicates partner relationship type.
412661847f8eSopenharmony_ci     *
412761847f8eSopenharmony_ci     * @type { number }
412861847f8eSopenharmony_ci     * @readonly
412961847f8eSopenharmony_ci     * @static
413061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
413161847f8eSopenharmony_ci     * @atomicservice
413261847f8eSopenharmony_ci     * @since 11
413361847f8eSopenharmony_ci     */
413461847f8eSopenharmony_ci    static readonly RELATION_PARTNER: 10
413561847f8eSopenharmony_ci
413661847f8eSopenharmony_ci    /**
413761847f8eSopenharmony_ci     * Indicates referrer relationship type.
413861847f8eSopenharmony_ci     *
413961847f8eSopenharmony_ci     * @type { number }
414061847f8eSopenharmony_ci     * @readonly
414161847f8eSopenharmony_ci     * @static
414261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
414361847f8eSopenharmony_ci     * @since 7
414461847f8eSopenharmony_ci     */
414561847f8eSopenharmony_ci    /**
414661847f8eSopenharmony_ci     * Indicates referrer relationship type.
414761847f8eSopenharmony_ci     *
414861847f8eSopenharmony_ci     * @type { number }
414961847f8eSopenharmony_ci     * @readonly
415061847f8eSopenharmony_ci     * @static
415161847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
415261847f8eSopenharmony_ci     * @atomicservice
415361847f8eSopenharmony_ci     * @since 11
415461847f8eSopenharmony_ci     */
415561847f8eSopenharmony_ci    static readonly RELATION_REFERRED_BY: 11
415661847f8eSopenharmony_ci
415761847f8eSopenharmony_ci    /**
415861847f8eSopenharmony_ci     * Indicates relative relationship type.
415961847f8eSopenharmony_ci     *
416061847f8eSopenharmony_ci     * @type { number }
416161847f8eSopenharmony_ci     * @readonly
416261847f8eSopenharmony_ci     * @static
416361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
416461847f8eSopenharmony_ci     * @since 7
416561847f8eSopenharmony_ci     */
416661847f8eSopenharmony_ci    /**
416761847f8eSopenharmony_ci     * Indicates relative relationship type.
416861847f8eSopenharmony_ci     *
416961847f8eSopenharmony_ci     * @type { number }
417061847f8eSopenharmony_ci     * @readonly
417161847f8eSopenharmony_ci     * @static
417261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
417361847f8eSopenharmony_ci     * @atomicservice
417461847f8eSopenharmony_ci     * @since 11
417561847f8eSopenharmony_ci     */
417661847f8eSopenharmony_ci    static readonly RELATION_RELATIVE: 12
417761847f8eSopenharmony_ci
417861847f8eSopenharmony_ci    /**
417961847f8eSopenharmony_ci     * Indicates sister relationship type.
418061847f8eSopenharmony_ci     *
418161847f8eSopenharmony_ci     * @type { number }
418261847f8eSopenharmony_ci     * @readonly
418361847f8eSopenharmony_ci     * @static
418461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
418561847f8eSopenharmony_ci     * @since 7
418661847f8eSopenharmony_ci     */
418761847f8eSopenharmony_ci    /**
418861847f8eSopenharmony_ci     * Indicates sister relationship type.
418961847f8eSopenharmony_ci     *
419061847f8eSopenharmony_ci     * @type { number }
419161847f8eSopenharmony_ci     * @readonly
419261847f8eSopenharmony_ci     * @static
419361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
419461847f8eSopenharmony_ci     * @atomicservice
419561847f8eSopenharmony_ci     * @since 11
419661847f8eSopenharmony_ci     */
419761847f8eSopenharmony_ci    static readonly RELATION_SISTER: 13
419861847f8eSopenharmony_ci
419961847f8eSopenharmony_ci    /**
420061847f8eSopenharmony_ci     * Indicates spouse relationship type.
420161847f8eSopenharmony_ci     *
420261847f8eSopenharmony_ci     * @type { number }
420361847f8eSopenharmony_ci     * @readonly
420461847f8eSopenharmony_ci     * @static
420561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
420661847f8eSopenharmony_ci     * @since 7
420761847f8eSopenharmony_ci     */
420861847f8eSopenharmony_ci    /**
420961847f8eSopenharmony_ci     * Indicates spouse relationship type.
421061847f8eSopenharmony_ci     *
421161847f8eSopenharmony_ci     * @type { number }
421261847f8eSopenharmony_ci     * @readonly
421361847f8eSopenharmony_ci     * @static
421461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
421561847f8eSopenharmony_ci     * @atomicservice
421661847f8eSopenharmony_ci     * @since 11
421761847f8eSopenharmony_ci     */
421861847f8eSopenharmony_ci    static readonly RELATION_SPOUSE: 14
421961847f8eSopenharmony_ci
422061847f8eSopenharmony_ci    /**
422161847f8eSopenharmony_ci     * Indicates invalid relationship type.
422261847f8eSopenharmony_ci     *
422361847f8eSopenharmony_ci     * @type { number }
422461847f8eSopenharmony_ci     * @readonly
422561847f8eSopenharmony_ci     * @static
422661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
422761847f8eSopenharmony_ci     * @since 7
422861847f8eSopenharmony_ci     */
422961847f8eSopenharmony_ci    /**
423061847f8eSopenharmony_ci     * Indicates invalid relationship type.
423161847f8eSopenharmony_ci     *
423261847f8eSopenharmony_ci     * @type { number }
423361847f8eSopenharmony_ci     * @readonly
423461847f8eSopenharmony_ci     * @static
423561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
423661847f8eSopenharmony_ci     * @atomicservice
423761847f8eSopenharmony_ci     * @since 11
423861847f8eSopenharmony_ci     */
423961847f8eSopenharmony_ci    static readonly INVALID_LABEL_ID: -1
424061847f8eSopenharmony_ci
424161847f8eSopenharmony_ci    /**
424261847f8eSopenharmony_ci     * Indicates the label name of an attribute.
424361847f8eSopenharmony_ci     *
424461847f8eSopenharmony_ci     * @type { ?string }
424561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
424661847f8eSopenharmony_ci     * @since 7
424761847f8eSopenharmony_ci     */
424861847f8eSopenharmony_ci    /**
424961847f8eSopenharmony_ci     * Indicates the label name of an attribute.
425061847f8eSopenharmony_ci     *
425161847f8eSopenharmony_ci     * @type { ?string }
425261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
425361847f8eSopenharmony_ci     * @atomicservice
425461847f8eSopenharmony_ci     * @since 11
425561847f8eSopenharmony_ci     */
425661847f8eSopenharmony_ci    labelName?: string
425761847f8eSopenharmony_ci
425861847f8eSopenharmony_ci    /**
425961847f8eSopenharmony_ci     * Indicates the relation name.
426061847f8eSopenharmony_ci     *
426161847f8eSopenharmony_ci     * @type { string }
426261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
426361847f8eSopenharmony_ci     * @since 7
426461847f8eSopenharmony_ci     */
426561847f8eSopenharmony_ci    /**
426661847f8eSopenharmony_ci     * Indicates the relation name.
426761847f8eSopenharmony_ci     *
426861847f8eSopenharmony_ci     * @type { string }
426961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
427061847f8eSopenharmony_ci     * @atomicservice
427161847f8eSopenharmony_ci     * @since 11
427261847f8eSopenharmony_ci     */
427361847f8eSopenharmony_ci    relationName: string
427461847f8eSopenharmony_ci
427561847f8eSopenharmony_ci    /**
427661847f8eSopenharmony_ci     * Indicates the label id.
427761847f8eSopenharmony_ci     *
427861847f8eSopenharmony_ci     * @type { ?number }
427961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
428061847f8eSopenharmony_ci     * @since 7
428161847f8eSopenharmony_ci     */
428261847f8eSopenharmony_ci    /**
428361847f8eSopenharmony_ci     * Indicates the label id.
428461847f8eSopenharmony_ci     *
428561847f8eSopenharmony_ci     * @type { ?number }
428661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
428761847f8eSopenharmony_ci     * @atomicservice
428861847f8eSopenharmony_ci     * @since 11
428961847f8eSopenharmony_ci     */
429061847f8eSopenharmony_ci    labelId?: number
429161847f8eSopenharmony_ci  }
429261847f8eSopenharmony_ci
429361847f8eSopenharmony_ci  /**
429461847f8eSopenharmony_ci   * Provides methods for sip address information
429561847f8eSopenharmony_ci   *
429661847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
429761847f8eSopenharmony_ci   * @since 7
429861847f8eSopenharmony_ci   */
429961847f8eSopenharmony_ci  /**
430061847f8eSopenharmony_ci   * Provides methods for sip address information
430161847f8eSopenharmony_ci   *
430261847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
430361847f8eSopenharmony_ci   * @atomicservice
430461847f8eSopenharmony_ci   * @since 11
430561847f8eSopenharmony_ci   */
430661847f8eSopenharmony_ci  class SipAddress {
430761847f8eSopenharmony_ci    /**
430861847f8eSopenharmony_ci     * Indicates a custom label.
430961847f8eSopenharmony_ci     *
431061847f8eSopenharmony_ci     * @type { number }
431161847f8eSopenharmony_ci     * @readonly
431261847f8eSopenharmony_ci     * @static
431361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
431461847f8eSopenharmony_ci     * @since 7
431561847f8eSopenharmony_ci     */
431661847f8eSopenharmony_ci    /**
431761847f8eSopenharmony_ci     * Indicates a custom label.
431861847f8eSopenharmony_ci     *
431961847f8eSopenharmony_ci     * @type { number }
432061847f8eSopenharmony_ci     * @readonly
432161847f8eSopenharmony_ci     * @static
432261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
432361847f8eSopenharmony_ci     * @atomicservice
432461847f8eSopenharmony_ci     * @since 11
432561847f8eSopenharmony_ci     */
432661847f8eSopenharmony_ci    static readonly CUSTOM_LABEL: 0
432761847f8eSopenharmony_ci
432861847f8eSopenharmony_ci    /**
432961847f8eSopenharmony_ci     * Indicates a home SIP address.
433061847f8eSopenharmony_ci     *
433161847f8eSopenharmony_ci     * @type { number }
433261847f8eSopenharmony_ci     * @readonly
433361847f8eSopenharmony_ci     * @static
433461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
433561847f8eSopenharmony_ci     * @since 7
433661847f8eSopenharmony_ci     */
433761847f8eSopenharmony_ci    /**
433861847f8eSopenharmony_ci     * Indicates a home SIP address.
433961847f8eSopenharmony_ci     *
434061847f8eSopenharmony_ci     * @type { number }
434161847f8eSopenharmony_ci     * @readonly
434261847f8eSopenharmony_ci     * @static
434361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
434461847f8eSopenharmony_ci     * @atomicservice
434561847f8eSopenharmony_ci     * @since 11
434661847f8eSopenharmony_ci     */
434761847f8eSopenharmony_ci    static readonly SIP_HOME: 1
434861847f8eSopenharmony_ci
434961847f8eSopenharmony_ci    /**
435061847f8eSopenharmony_ci     * Indicates a work SIP address.
435161847f8eSopenharmony_ci     *
435261847f8eSopenharmony_ci     * @type { number }
435361847f8eSopenharmony_ci     * @readonly
435461847f8eSopenharmony_ci     * @static
435561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
435661847f8eSopenharmony_ci     * @since 7
435761847f8eSopenharmony_ci     */
435861847f8eSopenharmony_ci    /**
435961847f8eSopenharmony_ci     * Indicates a work SIP address.
436061847f8eSopenharmony_ci     *
436161847f8eSopenharmony_ci     * @type { number }
436261847f8eSopenharmony_ci     * @readonly
436361847f8eSopenharmony_ci     * @static
436461847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
436561847f8eSopenharmony_ci     * @atomicservice
436661847f8eSopenharmony_ci     * @since 11
436761847f8eSopenharmony_ci     */
436861847f8eSopenharmony_ci    static readonly SIP_WORK: 2
436961847f8eSopenharmony_ci
437061847f8eSopenharmony_ci    /**
437161847f8eSopenharmony_ci     * Indicates an SIP address of the OTHER type.
437261847f8eSopenharmony_ci     *
437361847f8eSopenharmony_ci     * @type { number }
437461847f8eSopenharmony_ci     * @readonly
437561847f8eSopenharmony_ci     * @static
437661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
437761847f8eSopenharmony_ci     * @since 7
437861847f8eSopenharmony_ci     */
437961847f8eSopenharmony_ci    /**
438061847f8eSopenharmony_ci     * Indicates an SIP address of the OTHER type.
438161847f8eSopenharmony_ci     *
438261847f8eSopenharmony_ci     * @type { number }
438361847f8eSopenharmony_ci     * @readonly
438461847f8eSopenharmony_ci     * @static
438561847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
438661847f8eSopenharmony_ci     * @atomicservice
438761847f8eSopenharmony_ci     * @since 11
438861847f8eSopenharmony_ci     */
438961847f8eSopenharmony_ci    static readonly SIP_OTHER: 3
439061847f8eSopenharmony_ci
439161847f8eSopenharmony_ci    /**
439261847f8eSopenharmony_ci     * Indicates an invalid label ID.
439361847f8eSopenharmony_ci     *
439461847f8eSopenharmony_ci     * @type { number }
439561847f8eSopenharmony_ci     * @readonly
439661847f8eSopenharmony_ci     * @static
439761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
439861847f8eSopenharmony_ci     * @since 7
439961847f8eSopenharmony_ci     */
440061847f8eSopenharmony_ci    /**
440161847f8eSopenharmony_ci     * Indicates an invalid label ID.
440261847f8eSopenharmony_ci     *
440361847f8eSopenharmony_ci     * @type { number }
440461847f8eSopenharmony_ci     * @readonly
440561847f8eSopenharmony_ci     * @static
440661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
440761847f8eSopenharmony_ci     * @atomicservice
440861847f8eSopenharmony_ci     * @since 11
440961847f8eSopenharmony_ci     */
441061847f8eSopenharmony_ci    static readonly INVALID_LABEL_ID: -1
441161847f8eSopenharmony_ci
441261847f8eSopenharmony_ci    /**
441361847f8eSopenharmony_ci     * Indicates the label name of an attribute.
441461847f8eSopenharmony_ci     *
441561847f8eSopenharmony_ci     * @type { ?string }
441661847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
441761847f8eSopenharmony_ci     * @since 7
441861847f8eSopenharmony_ci     */
441961847f8eSopenharmony_ci    /**
442061847f8eSopenharmony_ci     * Indicates the label name of an attribute.
442161847f8eSopenharmony_ci     *
442261847f8eSopenharmony_ci     * @type { ?string }
442361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
442461847f8eSopenharmony_ci     * @atomicservice
442561847f8eSopenharmony_ci     * @since 11
442661847f8eSopenharmony_ci     */
442761847f8eSopenharmony_ci    labelName?: string
442861847f8eSopenharmony_ci
442961847f8eSopenharmony_ci    /**
443061847f8eSopenharmony_ci     * Indicates the SIP address.
443161847f8eSopenharmony_ci     *
443261847f8eSopenharmony_ci     * @type { string }
443361847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
443461847f8eSopenharmony_ci     * @since 7
443561847f8eSopenharmony_ci     */
443661847f8eSopenharmony_ci    /**
443761847f8eSopenharmony_ci     * Indicates the SIP address.
443861847f8eSopenharmony_ci     *
443961847f8eSopenharmony_ci     * @type { string }
444061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
444161847f8eSopenharmony_ci     * @atomicservice
444261847f8eSopenharmony_ci     * @since 11
444361847f8eSopenharmony_ci     */
444461847f8eSopenharmony_ci    sipAddress: string
444561847f8eSopenharmony_ci
444661847f8eSopenharmony_ci    /**
444761847f8eSopenharmony_ci     * Indicates the label id.
444861847f8eSopenharmony_ci     *
444961847f8eSopenharmony_ci     * @type { ?number }
445061847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
445161847f8eSopenharmony_ci     * @since 7
445261847f8eSopenharmony_ci     */
445361847f8eSopenharmony_ci    /**
445461847f8eSopenharmony_ci     * Indicates the label id.
445561847f8eSopenharmony_ci     *
445661847f8eSopenharmony_ci     * @type { ?number }
445761847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
445861847f8eSopenharmony_ci     * @atomicservice
445961847f8eSopenharmony_ci     * @since 11
446061847f8eSopenharmony_ci     */
446161847f8eSopenharmony_ci    labelId?: number
446261847f8eSopenharmony_ci  }
446361847f8eSopenharmony_ci
446461847f8eSopenharmony_ci  /**
446561847f8eSopenharmony_ci   * Provides methods for website information
446661847f8eSopenharmony_ci   *
446761847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
446861847f8eSopenharmony_ci   * @since 7
446961847f8eSopenharmony_ci   */
447061847f8eSopenharmony_ci  /**
447161847f8eSopenharmony_ci   * Provides methods for website information
447261847f8eSopenharmony_ci   *
447361847f8eSopenharmony_ci   * @syscap SystemCapability.Applications.ContactsData
447461847f8eSopenharmony_ci   * @atomicservice
447561847f8eSopenharmony_ci   * @since 11
447661847f8eSopenharmony_ci   */
447761847f8eSopenharmony_ci  class Website {
447861847f8eSopenharmony_ci    /**
447961847f8eSopenharmony_ci     * Indicates the website.
448061847f8eSopenharmony_ci     *
448161847f8eSopenharmony_ci     * @type { string }
448261847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
448361847f8eSopenharmony_ci     * @since 7
448461847f8eSopenharmony_ci     */
448561847f8eSopenharmony_ci    /**
448661847f8eSopenharmony_ci     * Indicates the website.
448761847f8eSopenharmony_ci     *
448861847f8eSopenharmony_ci     * @type { string }
448961847f8eSopenharmony_ci     * @syscap SystemCapability.Applications.ContactsData
449061847f8eSopenharmony_ci     * @atomicservice
449161847f8eSopenharmony_ci     * @since 11
449261847f8eSopenharmony_ci     */
449361847f8eSopenharmony_ci    website: string
449461847f8eSopenharmony_ci  }
449561847f8eSopenharmony_ci}
449661847f8eSopenharmony_ci
449761847f8eSopenharmony_ciexport default contact;