amis-rpc-design/node_modules/react-native/Libraries/Utilities/verifyComponentAttributeEquivalence.js
2023-10-07 19:42:30 +08:00

131 lines
3.9 KiB
JavaScript

/**
* Copyright (c) Meta Platforms, Inc. and affiliates.
*
* This source code is licensed under the MIT license found in the
* LICENSE file in the root directory of this source tree.
*
* @format
* @flow
*/
import PlatformBaseViewConfig from '../NativeComponent/PlatformBaseViewConfig';
import {type ViewConfig} from '../Renderer/shims/ReactNativeTypes';
const IGNORED_KEYS = ['transform', 'hitSlop'];
/**
* The purpose of this function is to validate that the view config that
* native exposes for a given view manager is the same as the view config
* that is specified for that view manager in JS.
*
* In order to improve perf, we want to avoid calling into native to get
* the view config when each view manager is used. To do this, we are moving
* the configs to JS. In the future we will use these JS based view configs
* to codegen the view manager on native to ensure they stay in sync without
* this runtime check.
*
* If this function fails, that likely means a change was made to the native
* view manager without updating the JS config as well. Ideally you can make
* that direct change to the JS config. If you don't know what the differences
* are, the best approach I've found is to create a view that prints
* the return value of getNativeComponentAttributes, and then copying that
* text and pasting it back into JS:
* <Text selectable={true}>{JSON.stringify(getNativeComponentAttributes('RCTView'))}</Text>
*
* This is meant to be a stopgap until the time comes when we only have a
* single source of truth. I wonder if this message will still be here two
* years from now...
*/
export default function verifyComponentAttributeEquivalence(
nativeViewConfig: ViewConfig,
staticViewConfig: ViewConfig,
) {
for (const prop of [
'validAttributes',
'bubblingEventTypes',
'directEventTypes',
]) {
const diff = Object.keys(
lefthandObjectDiff(nativeViewConfig[prop], staticViewConfig[prop]),
);
if (diff.length > 0) {
const name =
staticViewConfig.uiViewClassName ?? nativeViewConfig.uiViewClassName;
console.error(
`'${name}' has a view config that does not match native. ` +
`'${prop}' is missing: ${diff.join(', ')}`,
);
}
}
}
// Return the different key-value pairs of the right object, by iterating through the keys in the left object
// Note it won't return a difference where a key is missing in the left but exists the right.
function lefthandObjectDiff(leftObj: Object, rightObj: Object): Object {
const differentKeys: {[string]: any | {...}} = {};
function compare(leftItem: any, rightItem: any, key: string) {
if (typeof leftItem !== typeof rightItem && leftItem != null) {
differentKeys[key] = rightItem;
return;
}
if (typeof leftItem === 'object') {
const objDiff = lefthandObjectDiff(leftItem, rightItem);
if (Object.keys(objDiff).length > 1) {
differentKeys[key] = objDiff;
}
return;
}
if (leftItem !== rightItem) {
differentKeys[key] = rightItem;
return;
}
}
for (const key in leftObj) {
if (IGNORED_KEYS.includes(key)) {
continue;
}
if (!rightObj) {
differentKeys[key] = {};
} else if (leftObj.hasOwnProperty(key)) {
compare(leftObj[key], rightObj[key], key);
}
}
return differentKeys;
}
export function getConfigWithoutViewProps(
viewConfig: ViewConfig,
propName: string,
): {...} {
if (!viewConfig[propName]) {
return {};
}
return Object.keys(viewConfig[propName])
.filter(prop => !PlatformBaseViewConfig[propName][prop])
.reduce<{[string]: any}>((obj, prop) => {
obj[prop] = viewConfig[propName][prop];
return obj;
}, {});
}
export function stringifyViewConfig(viewConfig: any): string {
return JSON.stringify(
viewConfig,
(key, val) => {
if (typeof val === 'function') {
return `ƒ ${val.name}`;
}
return val;
},
2,
);
}