Files
react-native/flow/HermesInternalType.js
T
Nicola Corti dcfa0dc392 Fix broken CI with a run of prettier
Summary:
This Diff is fixing a broken CircleCI on OSS due to
not properly formatted .js files. See https://app.circleci.com/pipelines/github/facebook/react-native/10040/workflows/923cb408-b09c-4425-87c1-2677a7af9681/jobs/213822

The offending diff was D29986749 (https://github.com/facebook/react-native/commit/ff4b33672a6a27d2ed68ae6602e9d29d9b7c3eb1)

Changelog:
[Internal] - Fix broken CI due to not formatted js files

Reviewed By: ShikaSD

Differential Revision: D30515439

fbshipit-source-id: 560de04347a8746065981b534ed96f0956d94b9c
2021-08-24 11:14:46 -07:00

115 lines
3.8 KiB
JavaScript

/**
* Copyright (c) Facebook, Inc. and its affiliates.
*
* This source code is licensed under the MIT license found in the
* LICENSE file in the root directory of this source tree.
*
* @flow strict
* @format
*/
// Declarations for functionality exposed by the Hermes VM.
//
// For backwards-compatibility, code that uses such functionality must also
// check explicitly at run-time whether the object(s) and method(s) exist, and
// fail safely if not.
/**
* HermesInternalType is an object containing functions used to interact with
* the VM in a way that is not standardized by the JS spec.
* There are limited guarantees about these functions, and they should not be
* widely used. Consult with the Hermes team before using any of these.
* There may be other visible properties on this object; however, those are
* only exposed for testing purposes: do not use them.
*/
declare type $HermesInternalType = {
// All members are optional because they may not exist when OTA'd to older
// VMs.
+getNumGCs?: () => number,
+getGCTime?: () => number,
+getNativeCallTime?: () => number,
+getNativeCallCount?: () => number,
+getGCCPUTime?: () => number,
/**
* Hermes can embed an "epilogue" to the bytecode file with arbitrary bytes.
* At most one epilogue will exist per bytecode module (which can be
* different than a JS module).
* Calling this function will return all such epilogues and convert the
* bytes to numbers in the range of 0-255.
*/
+getEpilogues?: () => Array<Array<number>>,
/**
* Query the VM for various statistics about performance.
* There are no guarantees about what keys exist in it, but they can be
* printed for informational purposes.
* @return An object that maps strings to various types of performance
* statistics.
*/
+getInstrumentedStats?: () => {[string]: number | string, ...},
/**
* Query the VM for any sort of runtime properties that it wants to report.
* There are no guarantees about what keys exist in it, but they can be
* printed for informational purposes.
* @return An object that maps strings to various types of runtime properties.
*/
+getRuntimeProperties?: () => {
'OSS Release Version': string,
Build: string,
[string]: mixed,
},
/**
* Tell Hermes that at this point the surface has transitioned from TTI to
* post-TTI. The VM can change some of its internal behavior to optimize for
* post-TTI scenarios.
* This can be called several times but will have no effect after the first
* call.
*/
+ttiReached?: () => void,
/**
* Tell Hermes that at this point the surface has transitioned from TTRC to
* post-TTRC. The VM can change some of its internal behavior to optimize for
* post-TTRC scenarios.
* This can be called several times but will have no effect after the first
* call.
*/
+ttrcReached?: () => void,
/**
* Query the VM to see whether or not it enabled Promise.
*/
+hasPromise?: () => boolean,
/**
* Enable promise rejection tracking with the given options.
* The API mirrored the `promise` npm package, therefore it's typed same as
* the `enable` function of module `promise/setimmediate/rejection-tracking`
* declared in ./flow-typed/npm/promise_v8.x.x.js.
*/
+enablePromiseRejectionTracker?: (
options: ?{
whitelist?: ?Array<mixed>,
allRejections?: ?boolean,
onUnhandled?: ?(number, mixed) => void,
onHandled?: ?(number, mixed) => void,
},
) => void,
/**
* Query the VM to see whether or not it use the engine Job queue.
*/
+useEngineQueue?: () => boolean,
/**
* Enqueue a JavaScript callback function as a Job into the engine Job queue.
*/
+enqueueJob?: <TArguments: Array<mixed>>(
jobCallback: (...args: TArguments) => mixed,
) => void,
};