@enact/webos 4.6.1 → 4.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/LS2Request/LS2Request.d.ts +22 -0
- package/LS2Request/LS2Request.js +8 -1
- package/README.md +1 -1
- package/application/application.d.ts +32 -0
- package/deviceinfo/deviceinfo.d.ts +22 -0
- package/index.d.ts +0 -0
- package/keyboard/keyboard.d.ts +9 -0
- package/package.json +2 -2
- package/platform/platform.d.ts +15 -0
- package/pmloglib/pmloglib.d.ts +74 -0
- package/speech/VoiceControlDecorator.js +55 -54
- package/speech/index.d.ts +19 -0
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,14 @@
|
|
|
2
2
|
|
|
3
3
|
The following is a curated list of changes in the Enact webos module, newest changes on the top.
|
|
4
4
|
|
|
5
|
+
## [4.7.0] - 2023-04-25
|
|
6
|
+
|
|
7
|
+
No significant changes.
|
|
8
|
+
|
|
9
|
+
## [4.6.2] - 2023-03-09
|
|
10
|
+
|
|
11
|
+
No significant changes.
|
|
12
|
+
|
|
5
13
|
## [4.6.1] - 2023-02-03
|
|
6
14
|
|
|
7
15
|
No significant changes.
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
// Type definitions for webos/LS2Request
|
|
2
|
+
|
|
3
|
+
type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
|
|
4
|
+
type Merge<M, N> = Omit<M, Extract<keyof M, keyof N>> & N;
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* A class for managing LS2 Requests.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
export declare class LS2Request {
|
|
11
|
+
constructor();
|
|
12
|
+
/**
|
|
13
|
+
* Send a request to an LS2 service method.
|
|
14
|
+
*/
|
|
15
|
+
send(options: object): LS2Request;
|
|
16
|
+
/**
|
|
17
|
+
* Cancel the current LS2 request.
|
|
18
|
+
*/
|
|
19
|
+
cancel(): void;
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
export default LS2Request;
|
package/LS2Request/LS2Request.js
CHANGED
|
@@ -6,8 +6,15 @@ Object.defineProperty(exports, "__esModule", {
|
|
|
6
6
|
exports["default"] = void 0;
|
|
7
7
|
var _util = require("@enact/core/util");
|
|
8
8
|
function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
|
|
9
|
-
function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
|
|
9
|
+
function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
|
|
10
10
|
function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
|
|
11
|
+
function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
|
|
12
|
+
function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); } /* eslint-disable no-console */ /**
|
|
13
|
+
* Provides a class for making LS2 service requests on webOS platforms.
|
|
14
|
+
*
|
|
15
|
+
* @module webos/LS2Request
|
|
16
|
+
* @exports LS2Request
|
|
17
|
+
*/
|
|
11
18
|
var refs = {};
|
|
12
19
|
var adjustPath = function adjustPath(path) {
|
|
13
20
|
if (!/^(luna|palm):\/\//.test(path)) path = 'luna://' + path;
|
package/README.md
CHANGED
|
@@ -12,7 +12,7 @@ npm install --save @enact/webos
|
|
|
12
12
|
|
|
13
13
|
Unless otherwise specified, all content, including all source code files and documentation files in this repository are:
|
|
14
14
|
|
|
15
|
-
Copyright (c) 2012-
|
|
15
|
+
Copyright (c) 2012-2023 LG Electronics
|
|
16
16
|
|
|
17
17
|
Unless otherwise specified or set forth in the NOTICE file, all content, including all source code files and documentation files in this repository are: Licensed under the Apache License, Version 2.0 (the "License"); you may not use this content except in compliance with the License. You may obtain a copy of the License at
|
|
18
18
|
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
// Type definitions for webos/application
|
|
2
|
+
|
|
3
|
+
type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
|
|
4
|
+
type Merge<M, N> = Omit<M, Extract<keyof M, keyof N>> & N;
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Fetches the appID of the caller app.
|
|
8
|
+
*/
|
|
9
|
+
export function fetchAppId(): string;
|
|
10
|
+
/**
|
|
11
|
+
* The callback signature for `fetchAppInfo`
|
|
12
|
+
*/
|
|
13
|
+
export interface appInfoCallback {
|
|
14
|
+
(
|
|
15
|
+
/**
|
|
16
|
+
* JSON data object read from the app's _appinfo.json_ file. `undefined` if not found.
|
|
17
|
+
*/
|
|
18
|
+
info: any
|
|
19
|
+
): void;
|
|
20
|
+
}
|
|
21
|
+
/**
|
|
22
|
+
* Fetches the _appinfo.json_ data of the caller app.
|
|
23
|
+
*/
|
|
24
|
+
export function fetchAppInfo(callback: appInfoCallback, path?: string): void;
|
|
25
|
+
/**
|
|
26
|
+
* Fetches the full root URI (path) of the caller app.
|
|
27
|
+
*/
|
|
28
|
+
export function fetchAppRootPath(): string;
|
|
29
|
+
/**
|
|
30
|
+
* Emulate the remote _back_ key.
|
|
31
|
+
*/
|
|
32
|
+
export function platformBack(): void;
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
// Type definitions for webos/deviceinfo
|
|
2
|
+
|
|
3
|
+
type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
|
|
4
|
+
type Merge<M, N> = Omit<M, Extract<keyof M, keyof N>> & N;
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Callback signature for `deviceinfo`
|
|
8
|
+
*/
|
|
9
|
+
export interface deviceCallback {
|
|
10
|
+
(
|
|
11
|
+
/**
|
|
12
|
+
* JSON object containing the device information details
|
|
13
|
+
*/
|
|
14
|
+
info: object
|
|
15
|
+
): void;
|
|
16
|
+
}
|
|
17
|
+
/**
|
|
18
|
+
* Gets the device-specific information regarding model, OS version, specifications, etc.
|
|
19
|
+
*/
|
|
20
|
+
export function deviceinfo(callback: deviceCallback): void;
|
|
21
|
+
|
|
22
|
+
export default deviceinfo;
|
package/index.d.ts
ADDED
|
File without changes
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
// Type definitions for webos/keyboard
|
|
2
|
+
|
|
3
|
+
type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
|
|
4
|
+
type Merge<M, N> = Omit<M, Extract<keyof M, keyof N>> & N;
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Checks if the virtual keyboard is visible (only works on SmartTV platform).
|
|
8
|
+
*/
|
|
9
|
+
export function isShowing(): boolean;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@enact/webos",
|
|
3
|
-
"version": "4.
|
|
3
|
+
"version": "4.7.0",
|
|
4
4
|
"description": "webOS support library",
|
|
5
5
|
"repository": {
|
|
6
6
|
"type": "git",
|
|
@@ -31,7 +31,7 @@
|
|
|
31
31
|
}
|
|
32
32
|
},
|
|
33
33
|
"dependencies": {
|
|
34
|
-
"@enact/core": "^4.
|
|
34
|
+
"@enact/core": "^4.7.0",
|
|
35
35
|
"prop-types": "^15.8.1",
|
|
36
36
|
"react": "^18.2.0",
|
|
37
37
|
"react-dom": "^18.2.0"
|
|
@@ -0,0 +1,15 @@
|
|
|
1
|
+
// Type definitions for webos/platform
|
|
2
|
+
|
|
3
|
+
type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
|
|
4
|
+
type Merge<M, N> = Omit<M, Extract<keyof M, keyof N>> & N;
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Returns the object.
|
|
8
|
+
*/
|
|
9
|
+
export function detect(): object;
|
|
10
|
+
/**
|
|
11
|
+
* Provides identification of webOS variants.
|
|
12
|
+
*/
|
|
13
|
+
export declare const platform: object;
|
|
14
|
+
|
|
15
|
+
export default platform;
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
// Type definitions for webos/pmloglib
|
|
2
|
+
|
|
3
|
+
type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
|
|
4
|
+
type Merge<M, N> = Omit<M, Extract<keyof M, keyof N>> & N;
|
|
5
|
+
|
|
6
|
+
/**
|
|
7
|
+
* Logs with PmLogLib at the "emergency" level.
|
|
8
|
+
*/
|
|
9
|
+
export function emergency(
|
|
10
|
+
messageId: string,
|
|
11
|
+
keyVals: object,
|
|
12
|
+
freeText: string
|
|
13
|
+
): void;
|
|
14
|
+
/**
|
|
15
|
+
* Logs with PmLogLib at the "alert" level.
|
|
16
|
+
*/
|
|
17
|
+
export function alert(
|
|
18
|
+
messageId: string,
|
|
19
|
+
keyVals: object,
|
|
20
|
+
freeText: string
|
|
21
|
+
): void;
|
|
22
|
+
/**
|
|
23
|
+
* Logs with PmLogLib at the "critical" level.
|
|
24
|
+
*/
|
|
25
|
+
export function critical(
|
|
26
|
+
messageId: string,
|
|
27
|
+
keyVals: object,
|
|
28
|
+
freeText: string
|
|
29
|
+
): void;
|
|
30
|
+
/**
|
|
31
|
+
* Logs with PmLogLib at the "error" level.
|
|
32
|
+
*/
|
|
33
|
+
export function error(
|
|
34
|
+
messageId: string,
|
|
35
|
+
keyVals: object,
|
|
36
|
+
freeText: string
|
|
37
|
+
): void;
|
|
38
|
+
/**
|
|
39
|
+
* Logs with PmLogLib at the "warning" level.
|
|
40
|
+
*/
|
|
41
|
+
export function warning(
|
|
42
|
+
messageId: string,
|
|
43
|
+
keyVals: object,
|
|
44
|
+
freeText: string
|
|
45
|
+
): void;
|
|
46
|
+
/**
|
|
47
|
+
* Logs with PmLogLib at the "notice" level.
|
|
48
|
+
*/
|
|
49
|
+
export function notice(
|
|
50
|
+
messageId: string,
|
|
51
|
+
keyVals: object,
|
|
52
|
+
freeText: string
|
|
53
|
+
): void;
|
|
54
|
+
/**
|
|
55
|
+
* Logs with PmLogLib at the "info" level.
|
|
56
|
+
*/
|
|
57
|
+
export function info(
|
|
58
|
+
messageId: string,
|
|
59
|
+
keyVals: object,
|
|
60
|
+
freeText: string
|
|
61
|
+
): void;
|
|
62
|
+
/**
|
|
63
|
+
* Logs with PmLogLib at the "debug" level.
|
|
64
|
+
*/
|
|
65
|
+
export function debug(freeText: string): void;
|
|
66
|
+
/**
|
|
67
|
+
* Places a time-stamped performance log entry into the system log using the `PmLogInfoWithClock()`
|
|
68
|
+
method.
|
|
69
|
+
*/
|
|
70
|
+
export function perfLog(
|
|
71
|
+
messageId: string,
|
|
72
|
+
perfType: string,
|
|
73
|
+
perfGroup: string
|
|
74
|
+
): void;
|
|
@@ -12,68 +12,69 @@ var _jsxRuntime = require("react/jsx-runtime");
|
|
|
12
12
|
function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { "default": obj }; }
|
|
13
13
|
function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
|
|
14
14
|
function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
|
|
15
|
-
function _defineProperty(obj, key, value) { if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
|
|
15
|
+
function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
|
|
16
16
|
function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
|
|
17
|
-
function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, descriptor.key, descriptor); } }
|
|
17
|
+
function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
|
|
18
18
|
function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
|
|
19
|
+
function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return typeof key === "symbol" ? key : String(key); }
|
|
20
|
+
function _toPrimitive(input, hint) { if (typeof input !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (typeof res !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
|
|
19
21
|
function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
|
|
20
22
|
function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
|
|
21
23
|
function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
|
|
22
24
|
function _possibleConstructorReturn(self, call) { if (call && (typeof call === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
|
|
23
25
|
function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
|
|
24
26
|
function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
|
|
25
|
-
function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
*/
|
|
27
|
+
function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); } /**
|
|
28
|
+
* VoiceControlDecorator is a higher-order component that adds a callback for voice event
|
|
29
|
+
* to its wrapped component.
|
|
30
|
+
*
|
|
31
|
+
* By default, `onVoice` handler will be added to the node where `data-webos-voice-intent` attribute is declared.
|
|
32
|
+
* In addition, if you need to specify a target node, `data-webos-voice-event-target` attribute can be used.
|
|
33
|
+
*
|
|
34
|
+
* Usage:
|
|
35
|
+
* ```
|
|
36
|
+
* import {Component} from 'react';
|
|
37
|
+
* import Item from '@enact/moonstone/Item';
|
|
38
|
+
* import {VoiceControlDecorator} from '@enact/webos/speech';
|
|
39
|
+
*
|
|
40
|
+
* const VoiceDiv = VoiceControlDecorator('div');
|
|
41
|
+
* const VoiceItem = VoiceControlDecorator(Item);
|
|
42
|
+
*
|
|
43
|
+
* class Sample extends Component {
|
|
44
|
+
* handlePlayListControl = (e) => {
|
|
45
|
+
* const {intent, control} = e.detail;
|
|
46
|
+
* // Change the app status refer to the `control` value.
|
|
47
|
+
* }
|
|
48
|
+
*
|
|
49
|
+
* handlePlayContent = (e) => {
|
|
50
|
+
* const {intent, value} = e.detail;
|
|
51
|
+
* // Play content
|
|
52
|
+
* }
|
|
53
|
+
*
|
|
54
|
+
* render () {
|
|
55
|
+
* return(
|
|
56
|
+
* <div>
|
|
57
|
+
* <VoiceDiv
|
|
58
|
+
* data-webos-voice-intent='PlayListControl'
|
|
59
|
+
* onVoice={this.handlePlayListControl}
|
|
60
|
+
* />
|
|
61
|
+
* <VoiceItem
|
|
62
|
+
* data-webos-voice-intent='Select PlayContent'
|
|
63
|
+
* onVoice={this.handlePlayContent}
|
|
64
|
+
* >
|
|
65
|
+
* The Dark Knight
|
|
66
|
+
* </VoiceItem>
|
|
67
|
+
* </div>
|
|
68
|
+
* );
|
|
69
|
+
* }
|
|
70
|
+
* }
|
|
71
|
+
* ```
|
|
72
|
+
*
|
|
73
|
+
* @class VoiceControlDecorator
|
|
74
|
+
* @memberof webos/speech
|
|
75
|
+
* @hoc
|
|
76
|
+
* @public
|
|
77
|
+
*/
|
|
77
78
|
var VoiceControlDecorator = (0, _hoc["default"])(function (config, Wrapped) {
|
|
78
79
|
var _class;
|
|
79
80
|
return _class = /*#__PURE__*/function (_Component) {
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
// Type definitions for webos/speech
|
|
2
|
+
|
|
3
|
+
type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
|
|
4
|
+
type Merge<M, N> = Omit<M, Extract<keyof M, keyof N>> & N;
|
|
5
|
+
|
|
6
|
+
export interface VoiceControlDecoratorProps {
|
|
7
|
+
/**
|
|
8
|
+
* Callback to be executed when a wrapped element's `data-webos-voice-intent` is activated.
|
|
9
|
+
*/
|
|
10
|
+
onVoice: Function;
|
|
11
|
+
}
|
|
12
|
+
export function VoiceControlDecorator<P>(
|
|
13
|
+
Component: React.ComponentType<P> | string
|
|
14
|
+
): React.ComponentType<P & VoiceControlDecoratorProps>;
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* Read alert text when accessibility audio guidance is enabled.
|
|
18
|
+
*/
|
|
19
|
+
export function readAlert(string: string, clear: boolean): void;
|