refactor(native): isolate exact WVJB compatibility adapter
This commit is contained in:
@@ -0,0 +1,33 @@
|
||||
import assert from 'node:assert/strict';
|
||||
import { test } from 'node:test';
|
||||
|
||||
import { NativeSettingsAdapter } from '../../YouleNexus/assets/framework/adapters/native/native-settings-adapter.ts';
|
||||
|
||||
test('native settings calls the three original method spellings and preserves returns', () => {
|
||||
const calls: unknown[][] = [];
|
||||
const adapter = new NativeSettingsAdapter({
|
||||
getothername(name) {
|
||||
calls.push(['getothername', name]);
|
||||
return name === 'agent' ? 0 : `value:${name}`;
|
||||
},
|
||||
getchannelName() {
|
||||
calls.push(['getchannelName']);
|
||||
return 'channel-a';
|
||||
},
|
||||
getmarketname() {
|
||||
calls.push(['getmarketname']);
|
||||
return 17;
|
||||
},
|
||||
});
|
||||
|
||||
assert.equal(adapter.getOtherName('agent'), 0);
|
||||
assert.equal(adapter.getOtherName('gameserver'), 'value:gameserver');
|
||||
assert.equal(adapter.getChannelName(), 'channel-a');
|
||||
assert.equal(adapter.getMarketName(), 17);
|
||||
assert.deepEqual(calls, [
|
||||
['getothername', 'agent'],
|
||||
['getothername', 'gameserver'],
|
||||
['getchannelName'],
|
||||
['getmarketname'],
|
||||
]);
|
||||
});
|
||||
@@ -0,0 +1,261 @@
|
||||
import assert from 'node:assert/strict';
|
||||
import { test } from 'node:test';
|
||||
|
||||
import {
|
||||
NATIVE_CALL_NAMES,
|
||||
REGISTERED_NATIVE_HANDLER_NAMES,
|
||||
type NativeBridgeChannel,
|
||||
type NativeHandler,
|
||||
type NativeResponseCallback,
|
||||
} from '../../YouleNexus/assets/framework/adapters/native/native-contracts.ts';
|
||||
import {
|
||||
WebViewJavascriptBridgeAdapter,
|
||||
setupWebViewJavascriptBridge,
|
||||
type BridgeLoaderElement,
|
||||
type WebViewJavascriptBridgeEnvironment,
|
||||
} from '../../YouleNexus/assets/framework/adapters/native/webview-javascript-bridge.ts';
|
||||
|
||||
const EXPECTED_REGISTERED_NAMES = [
|
||||
'getVideoinfo', 'sharelogin', 'gameui_play_voice', 'gameui_stop_voice',
|
||||
'sharesuccess', 'getphoneinfo', 'getAddressBook', 'phonestate',
|
||||
'appservice', 'getaudiourl', 'getBattery', 'getwifiLevel', 'getnetwork',
|
||||
'shakeEnd', 'yPaytype', 'getlocationinfo', 'getWebdata',
|
||||
'PayuserPaytypePaystate', 'setPostUrl', 'getphoto',
|
||||
] as const;
|
||||
|
||||
const EXPECTED_CALL_NAMES = [
|
||||
'getphoto', 'h5Webpay', 'getVideoinfo', 'getphoneInfo', 'getAddressBook',
|
||||
'createRoom', 'exitRoom', 'accreditlogin', 'cancellogin',
|
||||
'OpenurlTitleData', 'getOther', 'voicePlaying', 'gameCopytext',
|
||||
'opencamera', 'gamepastetext', 'getGameinstall', 'getGameplay',
|
||||
'getphonestate', 'ypayType', 'SwitchOverGameData', 'backgameData',
|
||||
'startlocation', 'getlocationinfo', 'srcIsloop', 'opensaoma',
|
||||
'startshake', 'stopshake', 'SwitchShake', 'sharephotourl', 'browser',
|
||||
'mediaTypeAudio', 'prepareaudio', 'vibrator', 'repeatvibrator',
|
||||
'canclevibrator', 'orientation', 'notification',
|
||||
'friendsSharetypeUrlToptitleDescript',
|
||||
] as const;
|
||||
|
||||
interface RecordingEnvironment extends WebViewJavascriptBridgeEnvironment {
|
||||
created: BridgeLoaderElement[];
|
||||
domOperations: string[];
|
||||
events: Array<{ name: string; capture: boolean }>;
|
||||
removedEvents: Array<{ name: string; capture: boolean }>;
|
||||
runZeroDelayTimers(): void;
|
||||
fireReady(): void;
|
||||
}
|
||||
|
||||
function makeBridgeEnvironment(
|
||||
initial: { bridge?: NativeBridgeChannel; callbacks?: Array<(bridge: NativeBridgeChannel) => void> } = {},
|
||||
): RecordingEnvironment {
|
||||
const created: BridgeLoaderElement[] = [];
|
||||
const domOperations: string[] = [];
|
||||
const events: Array<{ name: string; capture: boolean }> = [];
|
||||
const removedEvents: Array<{ name: string; capture: boolean }> = [];
|
||||
const listeners = new Map<string, Set<() => void>>();
|
||||
const timers: Array<() => void> = [];
|
||||
const environment: RecordingEnvironment = {
|
||||
WebViewJavascriptBridge: initial.bridge,
|
||||
WVJBCallbacks: initial.callbacks,
|
||||
document: {
|
||||
addEventListener(name, listener, capture) {
|
||||
events.push({ name, capture });
|
||||
const owned = listeners.get(name) ?? new Set<() => void>();
|
||||
owned.add(listener);
|
||||
listeners.set(name, owned);
|
||||
},
|
||||
removeEventListener(name, listener, capture) {
|
||||
removedEvents.push({ name, capture });
|
||||
listeners.get(name)?.delete(listener);
|
||||
},
|
||||
createElement(tagName) {
|
||||
const element: BridgeLoaderElement = { tagName, style: { display: '' }, src: '' };
|
||||
created.push(element);
|
||||
return element;
|
||||
},
|
||||
documentElement: {
|
||||
appendChild(element) { domOperations.push(`append:${element.tagName}`); },
|
||||
removeChild(element) { domOperations.push(`remove:${element.tagName}`); },
|
||||
},
|
||||
},
|
||||
setTimeout(callback, delay) {
|
||||
assert.equal(delay, 0);
|
||||
timers.push(callback);
|
||||
return timers.length;
|
||||
},
|
||||
created,
|
||||
domOperations,
|
||||
events,
|
||||
removedEvents,
|
||||
runZeroDelayTimers() {
|
||||
for (const timer of timers.splice(0)) timer();
|
||||
},
|
||||
fireReady() {
|
||||
for (const listener of [...(listeners.get('WebViewJavascriptBridgeReady') ?? [])]) listener();
|
||||
},
|
||||
};
|
||||
return environment;
|
||||
}
|
||||
|
||||
function makeRecordingChannel() {
|
||||
const registered: Array<{ name: string; handler: NativeHandler }> = [];
|
||||
const called: Array<{ name: string; data: unknown; callback?: NativeResponseCallback }> = [];
|
||||
const channel: NativeBridgeChannel = {
|
||||
registerHandler(name, handler) { registered.push({ name, handler }); },
|
||||
callHandler(name, data, callback) { called.push({ name, data, callback }); },
|
||||
};
|
||||
return { channel, registered, called };
|
||||
}
|
||||
|
||||
test('existing WebViewJavascriptBridge calls back immediately', () => {
|
||||
const { channel: bridge } = makeRecordingChannel();
|
||||
const env = makeBridgeEnvironment({ bridge });
|
||||
const seen: unknown[] = [];
|
||||
setupWebViewJavascriptBridge(env, value => seen.push(value));
|
||||
assert.deepEqual(seen, [bridge]);
|
||||
});
|
||||
|
||||
test('immediate bridge branch still continues through the callback queue and iframe block', () => {
|
||||
const { channel: bridge } = makeRecordingChannel();
|
||||
const env = makeBridgeEnvironment({ bridge });
|
||||
const callback = () => undefined;
|
||||
setupWebViewJavascriptBridge(env, callback);
|
||||
assert.deepEqual(env.WVJBCallbacks, [callback]);
|
||||
assert.deepEqual(env.domOperations, ['append:iframe']);
|
||||
});
|
||||
|
||||
test('without bridge registers the exact ready listener', () => {
|
||||
const env = makeBridgeEnvironment();
|
||||
setupWebViewJavascriptBridge(env, () => undefined);
|
||||
assert.deepEqual(env.events, [{ name: 'WebViewJavascriptBridgeReady', capture: false }]);
|
||||
});
|
||||
|
||||
test('ready listener reads the bridge from the environment at event time', () => {
|
||||
const env = makeBridgeEnvironment();
|
||||
const { channel: bridge } = makeRecordingChannel();
|
||||
const seen: unknown[] = [];
|
||||
setupWebViewJavascriptBridge(env, value => seen.push(value));
|
||||
env.WebViewJavascriptBridge = bridge;
|
||||
env.fireReady();
|
||||
assert.deepEqual(seen, [bridge]);
|
||||
});
|
||||
|
||||
test('first WVJB callback creates and removes the loader iframe', () => {
|
||||
const env = makeBridgeEnvironment();
|
||||
setupWebViewJavascriptBridge(env, () => undefined);
|
||||
assert.equal(env.created[0].tagName, 'iframe');
|
||||
assert.equal(env.created[0].style.display, 'none');
|
||||
assert.equal(env.created[0].src, 'wvjbscheme://__BRIDGE_LOADED__');
|
||||
assert.deepEqual(env.domOperations, ['append:iframe']);
|
||||
env.runZeroDelayTimers();
|
||||
assert.deepEqual(env.domOperations, ['append:iframe', 'remove:iframe']);
|
||||
});
|
||||
|
||||
test('existing WVJB callback queue is appended without creating another iframe', () => {
|
||||
const first = () => undefined;
|
||||
const env = makeBridgeEnvironment({ callbacks: [first] });
|
||||
const second = () => undefined;
|
||||
setupWebViewJavascriptBridge(env, second);
|
||||
assert.deepEqual(env.WVJBCallbacks, [first, second]);
|
||||
assert.deepEqual(env.created, []);
|
||||
});
|
||||
|
||||
test('registered handler names preserve the complete active original tuple', () => {
|
||||
assert.deepEqual(REGISTERED_NATIVE_HANDLER_NAMES, EXPECTED_REGISTERED_NAMES);
|
||||
});
|
||||
|
||||
test('called native method names preserve the complete active original tuple', () => {
|
||||
assert.deepEqual(NATIVE_CALL_NAMES, EXPECTED_CALL_NAMES);
|
||||
});
|
||||
|
||||
test('register preserves handler identity and every callback argument in order', () => {
|
||||
const recording = makeRecordingChannel();
|
||||
const env = makeBridgeEnvironment({ bridge: recording.channel });
|
||||
const adapter = new WebViewJavascriptBridgeAdapter(env);
|
||||
const seen: unknown[][] = [];
|
||||
const handler: NativeHandler = (...args) => { seen.push(args); };
|
||||
adapter.register('PayuserPaytypePaystate', handler);
|
||||
|
||||
assert.equal(recording.registered[0].name, 'PayuserPaytypePaystate');
|
||||
assert.equal(recording.registered[0].handler, handler);
|
||||
const responseCallback = () => undefined;
|
||||
const args = [{ user: 1 }, 'type', 3, 'typeplay', { raw: true }, responseCallback] as const;
|
||||
recording.registered[0].handler(...args);
|
||||
assert.deepEqual(seen, [args]);
|
||||
});
|
||||
|
||||
test('call preserves payload and callback identity without changing callback arguments', () => {
|
||||
const recording = makeRecordingChannel();
|
||||
const env = makeBridgeEnvironment({ bridge: recording.channel });
|
||||
const adapter = new WebViewJavascriptBridgeAdapter(env);
|
||||
const payload = { exact: true };
|
||||
const responses: unknown[][] = [];
|
||||
const callback: NativeResponseCallback = (...args) => { responses.push(args); };
|
||||
adapter.call('notification', payload, callback);
|
||||
|
||||
assert.deepEqual(recording.called.map(({ name }) => name), ['notification']);
|
||||
assert.equal(recording.called[0].data, payload);
|
||||
assert.equal(recording.called[0].callback, callback);
|
||||
recording.called[0].callback?.('first', { second: true });
|
||||
assert.deepEqual(responses, [['first', { second: true }]]);
|
||||
});
|
||||
|
||||
test('unknown register and call names fail explicitly', () => {
|
||||
const recording = makeRecordingChannel();
|
||||
const adapter = new WebViewJavascriptBridgeAdapter(makeBridgeEnvironment({ bridge: recording.channel }));
|
||||
assert.throws(() => adapter.register('unknown' as never, () => undefined), /unknown/i);
|
||||
assert.throws(() => adapter.call('unknown' as never, {}), /unknown/i);
|
||||
});
|
||||
|
||||
test('registration queued before readiness runs once even if both original callbacks fire', () => {
|
||||
const recording = makeRecordingChannel();
|
||||
const env = makeBridgeEnvironment();
|
||||
const adapter = new WebViewJavascriptBridgeAdapter(env);
|
||||
adapter.register('getVideoinfo', () => undefined);
|
||||
env.WebViewJavascriptBridge = recording.channel;
|
||||
env.fireReady();
|
||||
for (const callback of [...(env.WVJBCallbacks ?? [])]) callback(recording.channel);
|
||||
assert.equal(adapter.isReady(), true);
|
||||
assert.deepEqual(recording.registered.map(({ name }) => name), ['getVideoinfo']);
|
||||
});
|
||||
|
||||
test('two adapter instances own independent channels without global active channel', () => {
|
||||
const first = makeRecordingChannel();
|
||||
const second = makeRecordingChannel();
|
||||
const globalRecord = globalThis as typeof globalThis & { __activeChannel?: unknown };
|
||||
const previous = globalRecord.__activeChannel;
|
||||
delete globalRecord.__activeChannel;
|
||||
try {
|
||||
const firstAdapter = new WebViewJavascriptBridgeAdapter(makeBridgeEnvironment({ bridge: first.channel }));
|
||||
const secondAdapter = new WebViewJavascriptBridgeAdapter(makeBridgeEnvironment({ bridge: second.channel }));
|
||||
firstAdapter.call('browser', { owner: 'first' });
|
||||
secondAdapter.call('browser', { owner: 'second' });
|
||||
assert.deepEqual(first.called.map(({ data }) => data), [{ owner: 'first' }]);
|
||||
assert.deepEqual(second.called.map(({ data }) => data), [{ owner: 'second' }]);
|
||||
assert.equal('__activeChannel' in globalRecord, false);
|
||||
} finally {
|
||||
if (previous !== undefined) globalRecord.__activeChannel = previous;
|
||||
else delete globalRecord.__activeChannel;
|
||||
}
|
||||
});
|
||||
|
||||
test('dispose removes only its ready listener and rejects later use', () => {
|
||||
const env = makeBridgeEnvironment();
|
||||
const first = new WebViewJavascriptBridgeAdapter(env);
|
||||
const second = new WebViewJavascriptBridgeAdapter(env);
|
||||
first.dispose();
|
||||
assert.deepEqual(env.removedEvents, [{ name: 'WebViewJavascriptBridgeReady', capture: false }]);
|
||||
|
||||
const recording = makeRecordingChannel();
|
||||
env.WebViewJavascriptBridge = recording.channel;
|
||||
env.fireReady();
|
||||
assert.throws(() => first.isReady(), /disposed/i);
|
||||
assert.equal(second.isReady(), true);
|
||||
assert.throws(() => first.register('getVideoinfo', () => undefined), /disposed/i);
|
||||
assert.throws(() => first.call('browser', ''), /disposed/i);
|
||||
});
|
||||
|
||||
test('call before readiness fails explicitly', () => {
|
||||
const adapter = new WebViewJavascriptBridgeAdapter(makeBridgeEnvironment());
|
||||
assert.throws(() => adapter.call('browser', ''), /not ready/i);
|
||||
});
|
||||
@@ -1,150 +0,0 @@
|
||||
import { test } from 'node:test';
|
||||
import assert from 'node:assert/strict';
|
||||
import {
|
||||
createBridge,
|
||||
getNativeSetting,
|
||||
type NativeHandler,
|
||||
type NativeResponseCallback,
|
||||
type NativeBridgeChannel,
|
||||
} from '../../YouleNexus/assets/framework/platform/native-bridge.ts';
|
||||
|
||||
/**
|
||||
* Mock 浏览器侧 globals。Node 单测无 window,需 stub。
|
||||
*/
|
||||
function makeEnv() {
|
||||
const calls: { handler: string; data: unknown }[] = [];
|
||||
const responses: Map<string, (data: any) => void> = new Map();
|
||||
const handlers: Map<string, NativeHandler> = new Map();
|
||||
|
||||
const channel: NativeBridgeChannel = {
|
||||
registerHandler(name, h) { handlers.set(name, h); },
|
||||
callHandler(name, data, cb) {
|
||||
calls.push({ handler: name, data });
|
||||
if (cb) responses.set(name, cb);
|
||||
},
|
||||
};
|
||||
|
||||
const g = globalThis as any;
|
||||
const oldWVJB = g.WVJBCallbacks;
|
||||
g.WVJBCallbacks = [];
|
||||
// mock 原生侧 WebView bridge 就绪:遍历 WVJBCallbacks 全调用
|
||||
const triggerReady = () => {
|
||||
for (const cb of [...g.WVJBCallbacks]) cb(channel);
|
||||
};
|
||||
|
||||
return {
|
||||
channel,
|
||||
restore: () => { g.WVJBCallbacks = oldWVJB; },
|
||||
calls,
|
||||
handlers,
|
||||
responses,
|
||||
triggerReady,
|
||||
};
|
||||
}
|
||||
|
||||
test('createBridge: 通道就绪时 onReady 触发', () => {
|
||||
const env = makeEnv();
|
||||
let got: any = null;
|
||||
const bridge = createBridge({
|
||||
onReady(c) { got = c; },
|
||||
});
|
||||
env.triggerReady();
|
||||
assert.equal(got, env.channel, 'onReady 应收到 mock channel');
|
||||
env.restore();
|
||||
});
|
||||
|
||||
test('registerHandler: H5 注册供原生调用', () => {
|
||||
const env = makeEnv();
|
||||
let received: any = null;
|
||||
const bridge = createBridge({
|
||||
onReady(c) {
|
||||
(globalThis as any).__activeChannel = c;
|
||||
bridge.registerHandler('getVideoinfo', (data) => {
|
||||
received = data;
|
||||
return { ok: true };
|
||||
});
|
||||
},
|
||||
});
|
||||
env.triggerReady();
|
||||
// 原生侧调用
|
||||
const handler = env.handlers.get('getVideoinfo');
|
||||
assert.ok(handler, 'handler 应已注册');
|
||||
handler!({ vid: 'abc' }, (() => {}) as NativeResponseCallback);
|
||||
assert.deepEqual(received, { vid: 'abc' });
|
||||
env.restore();
|
||||
});
|
||||
|
||||
test('callHandler: H5 调用原生,响应通过 cb 接收', () => {
|
||||
const env = makeEnv();
|
||||
const bridge = createBridge({
|
||||
onReady(c) { (globalThis as any).__activeChannel = c; },
|
||||
});
|
||||
env.triggerReady();
|
||||
let resp: unknown = null;
|
||||
bridge.callHandler('getBattery', {}, (r) => { resp = r; });
|
||||
// 模拟原生侧响应
|
||||
const cb = env.responses.get('getBattery');
|
||||
assert.ok(cb, 'callHandler 应记录 cb');
|
||||
cb!({ level: 80, charging: false });
|
||||
assert.deepEqual(resp, { level: 80, charging: false });
|
||||
env.restore();
|
||||
});
|
||||
|
||||
test('callHandler: handler 名不在白名单 → 显式抛错（第二准则）', () => {
|
||||
const env = makeEnv();
|
||||
const bridge = createBridge({ onReady: () => {} });
|
||||
env.triggerReady();
|
||||
assert.throws(
|
||||
() => bridge.callHandler('unknown_handler' as any, {}, () => {}),
|
||||
/unknown_handler/,
|
||||
);
|
||||
env.restore();
|
||||
});
|
||||
|
||||
test('registerHandler: handler 名不在白名单 → 显式抛错', () => {
|
||||
const env = makeEnv();
|
||||
const bridge = createBridge({ onReady: () => {} });
|
||||
env.triggerReady();
|
||||
assert.throws(
|
||||
() => bridge.registerHandler('unknown_handler' as any, () => undefined),
|
||||
/unknown_handler/,
|
||||
);
|
||||
env.restore();
|
||||
});
|
||||
|
||||
test('bridge 未就绪时 callHandler/registerHandler 显式抛错', () => {
|
||||
const g = globalThis as any;
|
||||
const old = g.WVJBCallbacks;
|
||||
g.WVJBCallbacks = []; // 空队列,triggerReady 不被调用
|
||||
const bridge = createBridge({ onReady: () => {} });
|
||||
assert.throws(() => bridge.callHandler('getBattery', {}, () => {}), /not ready/i);
|
||||
assert.throws(() => bridge.registerHandler('getVideoinfo', (() => undefined) as any), /not ready/i);
|
||||
g.WVJBCallbacks = old;
|
||||
});
|
||||
|
||||
test('重复 createBridge: 多个 instance 各自注册独立回调', () => {
|
||||
const g = globalThis as any;
|
||||
const old = g.WVJBCallbacks;
|
||||
g.WVJBCallbacks = [];
|
||||
createBridge({ onReady: () => {} });
|
||||
createBridge({ onReady: () => {} });
|
||||
assert.equal(g.WVJBCallbacks.length, 2, '每个 instance 独立注册一个 cb');
|
||||
g.WVJBCallbacks = old;
|
||||
});
|
||||
|
||||
test('getNativeSetting: 同步取 window.settings.getothername', () => {
|
||||
const g = globalThis as any;
|
||||
const oldWindow = g.window;
|
||||
g.window = { settings: { getothername: (n: string) => n === 'agentid' ? 'A' : '' } };
|
||||
assert.equal(getNativeSetting('agentid'), 'A');
|
||||
assert.equal(getNativeSetting('missing'), '');
|
||||
g.window = oldWindow;
|
||||
});
|
||||
|
||||
test('getNativeSetting: window.settings 未注入 → 显式抛错（不静默兜底）', () => {
|
||||
const g = globalThis as any;
|
||||
const oldWindow = g.window;
|
||||
g.window = {}; // 无 settings
|
||||
assert.throws(() => getNativeSetting('agentid'), /window\.settings 未注入/);
|
||||
g.window = oldWindow;
|
||||
});
|
||||
Reference in New Issue
Block a user