iframe-link 1.0.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/LICENSE +21 -0
- package/README.md +103 -0
- package/dist/index.cjs +994 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +80 -0
- package/dist/index.d.ts +80 -0
- package/dist/index.js +984 -0
- package/dist/index.js.map +1 -0
- package/docs/README.ja.md +103 -0
- package/docs/README.zh-CN.md +103 -0
- package/docs/THIRD_PARTY_NOTICES.md +45 -0
- package/docs/assets/sdk-demo.en.png +0 -0
- package/docs/assets/sdk-demo.ja.png +0 -0
- package/docs/assets/sdk-demo.zh-CN.png +0 -0
- package/package.json +79 -0
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../node_modules/.pnpm/ms@2.1.3/node_modules/ms/index.js","../node_modules/.pnpm/debug@4.4.3/node_modules/debug/src/common.js","../node_modules/.pnpm/debug@4.4.3/node_modules/debug/src/browser.js","../src/types.ts","../src/utils.ts","../src/channelBridge.ts","../src/channelConnect.ts"],"sourcesContent":["/**\n * Helpers.\n */\n\nvar s = 1000;\nvar m = s * 60;\nvar h = m * 60;\nvar d = h * 24;\nvar w = d * 7;\nvar y = d * 365.25;\n\n/**\n * Parse or format the given `val`.\n *\n * Options:\n *\n * - `long` verbose formatting [false]\n *\n * @param {String|Number} val\n * @param {Object} [options]\n * @throws {Error} throw an error if val is not a non-empty string or a number\n * @return {String|Number}\n * @api public\n */\n\nmodule.exports = function (val, options) {\n options = options || {};\n var type = typeof val;\n if (type === 'string' && val.length > 0) {\n return parse(val);\n } else if (type === 'number' && isFinite(val)) {\n return options.long ? fmtLong(val) : fmtShort(val);\n }\n throw new Error(\n 'val is not a non-empty string or a valid number. val=' +\n JSON.stringify(val)\n );\n};\n\n/**\n * Parse the given `str` and return milliseconds.\n *\n * @param {String} str\n * @return {Number}\n * @api private\n */\n\nfunction parse(str) {\n str = String(str);\n if (str.length > 100) {\n return;\n }\n var match = /^(-?(?:\\d+)?\\.?\\d+) *(milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|weeks?|w|years?|yrs?|y)?$/i.exec(\n str\n );\n if (!match) {\n return;\n }\n var n = parseFloat(match[1]);\n var type = (match[2] || 'ms').toLowerCase();\n switch (type) {\n case 'years':\n case 'year':\n case 'yrs':\n case 'yr':\n case 'y':\n return n * y;\n case 'weeks':\n case 'week':\n case 'w':\n return n * w;\n case 'days':\n case 'day':\n case 'd':\n return n * d;\n case 'hours':\n case 'hour':\n case 'hrs':\n case 'hr':\n case 'h':\n return n * h;\n case 'minutes':\n case 'minute':\n case 'mins':\n case 'min':\n case 'm':\n return n * m;\n case 'seconds':\n case 'second':\n case 'secs':\n case 'sec':\n case 's':\n return n * s;\n case 'milliseconds':\n case 'millisecond':\n case 'msecs':\n case 'msec':\n case 'ms':\n return n;\n default:\n return undefined;\n }\n}\n\n/**\n * Short format for `ms`.\n *\n * @param {Number} ms\n * @return {String}\n * @api private\n */\n\nfunction fmtShort(ms) {\n var msAbs = Math.abs(ms);\n if (msAbs >= d) {\n return Math.round(ms / d) + 'd';\n }\n if (msAbs >= h) {\n return Math.round(ms / h) + 'h';\n }\n if (msAbs >= m) {\n return Math.round(ms / m) + 'm';\n }\n if (msAbs >= s) {\n return Math.round(ms / s) + 's';\n }\n return ms + 'ms';\n}\n\n/**\n * Long format for `ms`.\n *\n * @param {Number} ms\n * @return {String}\n * @api private\n */\n\nfunction fmtLong(ms) {\n var msAbs = Math.abs(ms);\n if (msAbs >= d) {\n return plural(ms, msAbs, d, 'day');\n }\n if (msAbs >= h) {\n return plural(ms, msAbs, h, 'hour');\n }\n if (msAbs >= m) {\n return plural(ms, msAbs, m, 'minute');\n }\n if (msAbs >= s) {\n return plural(ms, msAbs, s, 'second');\n }\n return ms + ' ms';\n}\n\n/**\n * Pluralization helper.\n */\n\nfunction plural(ms, msAbs, n, name) {\n var isPlural = msAbs >= n * 1.5;\n return Math.round(ms / n) + ' ' + name + (isPlural ? 's' : '');\n}\n","\n/**\n * This is the common logic for both the Node.js and web browser\n * implementations of `debug()`.\n */\n\nfunction setup(env) {\n\tcreateDebug.debug = createDebug;\n\tcreateDebug.default = createDebug;\n\tcreateDebug.coerce = coerce;\n\tcreateDebug.disable = disable;\n\tcreateDebug.enable = enable;\n\tcreateDebug.enabled = enabled;\n\tcreateDebug.humanize = require('ms');\n\tcreateDebug.destroy = destroy;\n\n\tObject.keys(env).forEach(key => {\n\t\tcreateDebug[key] = env[key];\n\t});\n\n\t/**\n\t* The currently active debug mode names, and names to skip.\n\t*/\n\n\tcreateDebug.names = [];\n\tcreateDebug.skips = [];\n\n\t/**\n\t* Map of special \"%n\" handling functions, for the debug \"format\" argument.\n\t*\n\t* Valid key names are a single, lower or upper-case letter, i.e. \"n\" and \"N\".\n\t*/\n\tcreateDebug.formatters = {};\n\n\t/**\n\t* Selects a color for a debug namespace\n\t* @param {String} namespace The namespace string for the debug instance to be colored\n\t* @return {Number|String} An ANSI color code for the given namespace\n\t* @api private\n\t*/\n\tfunction selectColor(namespace) {\n\t\tlet hash = 0;\n\n\t\tfor (let i = 0; i < namespace.length; i++) {\n\t\t\thash = ((hash << 5) - hash) + namespace.charCodeAt(i);\n\t\t\thash |= 0; // Convert to 32bit integer\n\t\t}\n\n\t\treturn createDebug.colors[Math.abs(hash) % createDebug.colors.length];\n\t}\n\tcreateDebug.selectColor = selectColor;\n\n\t/**\n\t* Create a debugger with the given `namespace`.\n\t*\n\t* @param {String} namespace\n\t* @return {Function}\n\t* @api public\n\t*/\n\tfunction createDebug(namespace) {\n\t\tlet prevTime;\n\t\tlet enableOverride = null;\n\t\tlet namespacesCache;\n\t\tlet enabledCache;\n\n\t\tfunction debug(...args) {\n\t\t\t// Disabled?\n\t\t\tif (!debug.enabled) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst self = debug;\n\n\t\t\t// Set `diff` timestamp\n\t\t\tconst curr = Number(new Date());\n\t\t\tconst ms = curr - (prevTime || curr);\n\t\t\tself.diff = ms;\n\t\t\tself.prev = prevTime;\n\t\t\tself.curr = curr;\n\t\t\tprevTime = curr;\n\n\t\t\targs[0] = createDebug.coerce(args[0]);\n\n\t\t\tif (typeof args[0] !== 'string') {\n\t\t\t\t// Anything else let's inspect with %O\n\t\t\t\targs.unshift('%O');\n\t\t\t}\n\n\t\t\t// Apply any `formatters` transformations\n\t\t\tlet index = 0;\n\t\t\targs[0] = args[0].replace(/%([a-zA-Z%])/g, (match, format) => {\n\t\t\t\t// If we encounter an escaped % then don't increase the array index\n\t\t\t\tif (match === '%%') {\n\t\t\t\t\treturn '%';\n\t\t\t\t}\n\t\t\t\tindex++;\n\t\t\t\tconst formatter = createDebug.formatters[format];\n\t\t\t\tif (typeof formatter === 'function') {\n\t\t\t\t\tconst val = args[index];\n\t\t\t\t\tmatch = formatter.call(self, val);\n\n\t\t\t\t\t// Now we need to remove `args[index]` since it's inlined in the `format`\n\t\t\t\t\targs.splice(index, 1);\n\t\t\t\t\tindex--;\n\t\t\t\t}\n\t\t\t\treturn match;\n\t\t\t});\n\n\t\t\t// Apply env-specific formatting (colors, etc.)\n\t\t\tcreateDebug.formatArgs.call(self, args);\n\n\t\t\tconst logFn = self.log || createDebug.log;\n\t\t\tlogFn.apply(self, args);\n\t\t}\n\n\t\tdebug.namespace = namespace;\n\t\tdebug.useColors = createDebug.useColors();\n\t\tdebug.color = createDebug.selectColor(namespace);\n\t\tdebug.extend = extend;\n\t\tdebug.destroy = createDebug.destroy; // XXX Temporary. Will be removed in the next major release.\n\n\t\tObject.defineProperty(debug, 'enabled', {\n\t\t\tenumerable: true,\n\t\t\tconfigurable: false,\n\t\t\tget: () => {\n\t\t\t\tif (enableOverride !== null) {\n\t\t\t\t\treturn enableOverride;\n\t\t\t\t}\n\t\t\t\tif (namespacesCache !== createDebug.namespaces) {\n\t\t\t\t\tnamespacesCache = createDebug.namespaces;\n\t\t\t\t\tenabledCache = createDebug.enabled(namespace);\n\t\t\t\t}\n\n\t\t\t\treturn enabledCache;\n\t\t\t},\n\t\t\tset: v => {\n\t\t\t\tenableOverride = v;\n\t\t\t}\n\t\t});\n\n\t\t// Env-specific initialization logic for debug instances\n\t\tif (typeof createDebug.init === 'function') {\n\t\t\tcreateDebug.init(debug);\n\t\t}\n\n\t\treturn debug;\n\t}\n\n\tfunction extend(namespace, delimiter) {\n\t\tconst newDebug = createDebug(this.namespace + (typeof delimiter === 'undefined' ? ':' : delimiter) + namespace);\n\t\tnewDebug.log = this.log;\n\t\treturn newDebug;\n\t}\n\n\t/**\n\t* Enables a debug mode by namespaces. This can include modes\n\t* separated by a colon and wildcards.\n\t*\n\t* @param {String} namespaces\n\t* @api public\n\t*/\n\tfunction enable(namespaces) {\n\t\tcreateDebug.save(namespaces);\n\t\tcreateDebug.namespaces = namespaces;\n\n\t\tcreateDebug.names = [];\n\t\tcreateDebug.skips = [];\n\n\t\tconst split = (typeof namespaces === 'string' ? namespaces : '')\n\t\t\t.trim()\n\t\t\t.replace(/\\s+/g, ',')\n\t\t\t.split(',')\n\t\t\t.filter(Boolean);\n\n\t\tfor (const ns of split) {\n\t\t\tif (ns[0] === '-') {\n\t\t\t\tcreateDebug.skips.push(ns.slice(1));\n\t\t\t} else {\n\t\t\t\tcreateDebug.names.push(ns);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Checks if the given string matches a namespace template, honoring\n\t * asterisks as wildcards.\n\t *\n\t * @param {String} search\n\t * @param {String} template\n\t * @return {Boolean}\n\t */\n\tfunction matchesTemplate(search, template) {\n\t\tlet searchIndex = 0;\n\t\tlet templateIndex = 0;\n\t\tlet starIndex = -1;\n\t\tlet matchIndex = 0;\n\n\t\twhile (searchIndex < search.length) {\n\t\t\tif (templateIndex < template.length && (template[templateIndex] === search[searchIndex] || template[templateIndex] === '*')) {\n\t\t\t\t// Match character or proceed with wildcard\n\t\t\t\tif (template[templateIndex] === '*') {\n\t\t\t\t\tstarIndex = templateIndex;\n\t\t\t\t\tmatchIndex = searchIndex;\n\t\t\t\t\ttemplateIndex++; // Skip the '*'\n\t\t\t\t} else {\n\t\t\t\t\tsearchIndex++;\n\t\t\t\t\ttemplateIndex++;\n\t\t\t\t}\n\t\t\t} else if (starIndex !== -1) { // eslint-disable-line no-negated-condition\n\t\t\t\t// Backtrack to the last '*' and try to match more characters\n\t\t\t\ttemplateIndex = starIndex + 1;\n\t\t\t\tmatchIndex++;\n\t\t\t\tsearchIndex = matchIndex;\n\t\t\t} else {\n\t\t\t\treturn false; // No match\n\t\t\t}\n\t\t}\n\n\t\t// Handle trailing '*' in template\n\t\twhile (templateIndex < template.length && template[templateIndex] === '*') {\n\t\t\ttemplateIndex++;\n\t\t}\n\n\t\treturn templateIndex === template.length;\n\t}\n\n\t/**\n\t* Disable debug output.\n\t*\n\t* @return {String} namespaces\n\t* @api public\n\t*/\n\tfunction disable() {\n\t\tconst namespaces = [\n\t\t\t...createDebug.names,\n\t\t\t...createDebug.skips.map(namespace => '-' + namespace)\n\t\t].join(',');\n\t\tcreateDebug.enable('');\n\t\treturn namespaces;\n\t}\n\n\t/**\n\t* Returns true if the given mode name is enabled, false otherwise.\n\t*\n\t* @param {String} name\n\t* @return {Boolean}\n\t* @api public\n\t*/\n\tfunction enabled(name) {\n\t\tfor (const skip of createDebug.skips) {\n\t\t\tif (matchesTemplate(name, skip)) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\n\t\tfor (const ns of createDebug.names) {\n\t\t\tif (matchesTemplate(name, ns)) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\n\t\treturn false;\n\t}\n\n\t/**\n\t* Coerce `val`.\n\t*\n\t* @param {Mixed} val\n\t* @return {Mixed}\n\t* @api private\n\t*/\n\tfunction coerce(val) {\n\t\tif (val instanceof Error) {\n\t\t\treturn val.stack || val.message;\n\t\t}\n\t\treturn val;\n\t}\n\n\t/**\n\t* XXX DO NOT USE. This is a temporary stub function.\n\t* XXX It WILL be removed in the next major release.\n\t*/\n\tfunction destroy() {\n\t\tconsole.warn('Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.');\n\t}\n\n\tcreateDebug.enable(createDebug.load());\n\n\treturn createDebug;\n}\n\nmodule.exports = setup;\n","/* eslint-env browser */\n\n/**\n * This is the web browser implementation of `debug()`.\n */\n\nexports.formatArgs = formatArgs;\nexports.save = save;\nexports.load = load;\nexports.useColors = useColors;\nexports.storage = localstorage();\nexports.destroy = (() => {\n\tlet warned = false;\n\n\treturn () => {\n\t\tif (!warned) {\n\t\t\twarned = true;\n\t\t\tconsole.warn('Instance method `debug.destroy()` is deprecated and no longer does anything. It will be removed in the next major version of `debug`.');\n\t\t}\n\t};\n})();\n\n/**\n * Colors.\n */\n\nexports.colors = [\n\t'#0000CC',\n\t'#0000FF',\n\t'#0033CC',\n\t'#0033FF',\n\t'#0066CC',\n\t'#0066FF',\n\t'#0099CC',\n\t'#0099FF',\n\t'#00CC00',\n\t'#00CC33',\n\t'#00CC66',\n\t'#00CC99',\n\t'#00CCCC',\n\t'#00CCFF',\n\t'#3300CC',\n\t'#3300FF',\n\t'#3333CC',\n\t'#3333FF',\n\t'#3366CC',\n\t'#3366FF',\n\t'#3399CC',\n\t'#3399FF',\n\t'#33CC00',\n\t'#33CC33',\n\t'#33CC66',\n\t'#33CC99',\n\t'#33CCCC',\n\t'#33CCFF',\n\t'#6600CC',\n\t'#6600FF',\n\t'#6633CC',\n\t'#6633FF',\n\t'#66CC00',\n\t'#66CC33',\n\t'#9900CC',\n\t'#9900FF',\n\t'#9933CC',\n\t'#9933FF',\n\t'#99CC00',\n\t'#99CC33',\n\t'#CC0000',\n\t'#CC0033',\n\t'#CC0066',\n\t'#CC0099',\n\t'#CC00CC',\n\t'#CC00FF',\n\t'#CC3300',\n\t'#CC3333',\n\t'#CC3366',\n\t'#CC3399',\n\t'#CC33CC',\n\t'#CC33FF',\n\t'#CC6600',\n\t'#CC6633',\n\t'#CC9900',\n\t'#CC9933',\n\t'#CCCC00',\n\t'#CCCC33',\n\t'#FF0000',\n\t'#FF0033',\n\t'#FF0066',\n\t'#FF0099',\n\t'#FF00CC',\n\t'#FF00FF',\n\t'#FF3300',\n\t'#FF3333',\n\t'#FF3366',\n\t'#FF3399',\n\t'#FF33CC',\n\t'#FF33FF',\n\t'#FF6600',\n\t'#FF6633',\n\t'#FF9900',\n\t'#FF9933',\n\t'#FFCC00',\n\t'#FFCC33'\n];\n\n/**\n * Currently only WebKit-based Web Inspectors, Firefox >= v31,\n * and the Firebug extension (any Firefox version) are known\n * to support \"%c\" CSS customizations.\n *\n * TODO: add a `localStorage` variable to explicitly enable/disable colors\n */\n\n// eslint-disable-next-line complexity\nfunction useColors() {\n\t// NB: In an Electron preload script, document will be defined but not fully\n\t// initialized. Since we know we're in Chrome, we'll just detect this case\n\t// explicitly\n\tif (typeof window !== 'undefined' && window.process && (window.process.type === 'renderer' || window.process.__nwjs)) {\n\t\treturn true;\n\t}\n\n\t// Internet Explorer and Edge do not support colors.\n\tif (typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/(edge|trident)\\/(\\d+)/)) {\n\t\treturn false;\n\t}\n\n\tlet m;\n\n\t// Is webkit? http://stackoverflow.com/a/16459606/376773\n\t// document is undefined in react-native: https://github.com/facebook/react-native/pull/1632\n\t// eslint-disable-next-line no-return-assign\n\treturn (typeof document !== 'undefined' && document.documentElement && document.documentElement.style && document.documentElement.style.WebkitAppearance) ||\n\t\t// Is firebug? http://stackoverflow.com/a/398120/376773\n\t\t(typeof window !== 'undefined' && window.console && (window.console.firebug || (window.console.exception && window.console.table))) ||\n\t\t// Is firefox >= v31?\n\t\t// https://developer.mozilla.org/en-US/docs/Tools/Web_Console#Styling_messages\n\t\t(typeof navigator !== 'undefined' && navigator.userAgent && (m = navigator.userAgent.toLowerCase().match(/firefox\\/(\\d+)/)) && parseInt(m[1], 10) >= 31) ||\n\t\t// Double check webkit in userAgent just in case we are in a worker\n\t\t(typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/applewebkit\\/(\\d+)/));\n}\n\n/**\n * Colorize log arguments if enabled.\n *\n * @api public\n */\n\nfunction formatArgs(args) {\n\targs[0] = (this.useColors ? '%c' : '') +\n\t\tthis.namespace +\n\t\t(this.useColors ? ' %c' : ' ') +\n\t\targs[0] +\n\t\t(this.useColors ? '%c ' : ' ') +\n\t\t'+' + module.exports.humanize(this.diff);\n\n\tif (!this.useColors) {\n\t\treturn;\n\t}\n\n\tconst c = 'color: ' + this.color;\n\targs.splice(1, 0, c, 'color: inherit');\n\n\t// The final \"%c\" is somewhat tricky, because there could be other\n\t// arguments passed either before or after the %c, so we need to\n\t// figure out the correct index to insert the CSS into\n\tlet index = 0;\n\tlet lastC = 0;\n\targs[0].replace(/%[a-zA-Z%]/g, match => {\n\t\tif (match === '%%') {\n\t\t\treturn;\n\t\t}\n\t\tindex++;\n\t\tif (match === '%c') {\n\t\t\t// We only are interested in the *last* %c\n\t\t\t// (the user may have provided their own)\n\t\t\tlastC = index;\n\t\t}\n\t});\n\n\targs.splice(lastC, 0, c);\n}\n\n/**\n * Invokes `console.debug()` when available.\n * No-op when `console.debug` is not a \"function\".\n * If `console.debug` is not available, falls back\n * to `console.log`.\n *\n * @api public\n */\nexports.log = console.debug || console.log || (() => {});\n\n/**\n * Save `namespaces`.\n *\n * @param {String} namespaces\n * @api private\n */\nfunction save(namespaces) {\n\ttry {\n\t\tif (namespaces) {\n\t\t\texports.storage.setItem('debug', namespaces);\n\t\t} else {\n\t\t\texports.storage.removeItem('debug');\n\t\t}\n\t} catch (error) {\n\t\t// Swallow\n\t\t// XXX (@Qix-) should we be logging these?\n\t}\n}\n\n/**\n * Load `namespaces`.\n *\n * @return {String} returns the previously persisted debug modes\n * @api private\n */\nfunction load() {\n\tlet r;\n\ttry {\n\t\tr = exports.storage.getItem('debug') || exports.storage.getItem('DEBUG') ;\n\t} catch (error) {\n\t\t// Swallow\n\t\t// XXX (@Qix-) should we be logging these?\n\t}\n\n\t// If debug isn't set in LS, and we're in Electron, try to load $DEBUG\n\tif (!r && typeof process !== 'undefined' && 'env' in process) {\n\t\tr = process.env.DEBUG;\n\t}\n\n\treturn r;\n}\n\n/**\n * Localstorage attempts to return the localstorage.\n *\n * This is necessary because safari throws\n * when a user disables cookies/localstorage\n * and you attempt to access it.\n *\n * @return {LocalStorage}\n * @api private\n */\n\nfunction localstorage() {\n\ttry {\n\t\t// TVMLKit (Apple TV JS Runtime) does not have a window object, just localStorage in the global context\n\t\t// The Browser also has localStorage in the global context.\n\t\treturn localStorage;\n\t} catch (error) {\n\t\t// Swallow\n\t\t// XXX (@Qix-) should we be logging these?\n\t}\n}\n\nmodule.exports = require('./common')(exports);\n\nconst {formatters} = module.exports;\n\n/**\n * Map %j to `JSON.stringify()`, since no Web Inspectors do that by default.\n */\n\nformatters.j = function (v) {\n\ttry {\n\t\treturn JSON.stringify(v);\n\t} catch (error) {\n\t\treturn '[UnexpectedJSONParseError]: ' + error.message;\n\t}\n};\n","export type AnyFunction = (params: any) => any\nexport type MessageHandler = (message: Message | NativeMessage) => void\n\n/**\n * SDK 协议消息类型\n */\nexport const SDK_MESSAGE_TYPES = ['READY', 'ACK', 'CALL', 'RESULT', 'EVENT'] as const\nexport type SDKMessageType = typeof SDK_MESSAGE_TYPES[number]\n\n/**\n * 标准 SDK 消息格式\n */\nexport interface Message {\n type: SDKMessageType\n id?: string\n method?: string\n params?: any\n result?: any\n error?: string\n eventType?: string\n data?: any\n}\n\n/**\n * 原生消息格式(给不使用 SDK 的子应用)\n * 子应用可以直接使用 postMessage 发送此格式的消息\n */\nexport interface NativeMessage {\n action: string\n data?: any\n requestId?: string\n}\n\n/**\n * 原生响应格式\n */\nexport interface NativeResponse {\n type: '__NATIVE_RESPONSE__'\n action: string\n requestId?: string\n success: boolean\n result?: any\n error?: string\n}\n\nexport interface IframeChannel<T = any> {\n promise: Promise<T>\n on: (type: string, fn: (data: any) => void) => void\n off: (type: string, fn: (data: any) => void) => void\n emit: (type: string, data?: any) => void\n destroy: () => void\n}\n\n/**\n * Origin 匹配规则\n * - string: 精确匹配\n * - RegExp: 正则匹配\n * - '*': 匹配所有(不推荐用于生产环境)\n */\nexport type OriginPattern = string | RegExp\n\n/**\n * 默认允许的示例 Origin;生产环境应显式配置 allowedOrigins\n */\nexport const DEFAULT_ALLOWED_ORIGIN = /^https:\\/\\/oa\\.example\\.com$/\n\ninterface BaseConnectOptions {\n methods?: Record<string, AnyFunction>\n debug?: boolean\n}\n\nexport interface ConnectToIframeOptions extends BaseConnectOptions {\n iframe: string | HTMLIFrameElement\n origin: string\n}\n\nexport interface ConnectToParentOptions extends BaseConnectOptions {\n allowedOrigins?: OriginPattern[]\n}\n\nexport type ConnectOptions = ConnectToIframeOptions | ConnectToParentOptions\n","import createDebug from 'debug'\nimport type { createMessenger } from './channelBridge'\nimport type { AnyFunction, OriginPattern } from './types'\n\ntype Messenger = ReturnType<typeof createMessenger>\n\n/**\n * 日志命名空间\n *\n * 启用方式:\n * - 浏览器: localStorage.debug = 'iframe-link:*'\n * - 只看特定模块: localStorage.debug = 'iframe-link:bridge'\n * - 查看时间戳: Chrome DevTools → Console → 设置 → Show timestamps\n */\nconst NAMESPACE = 'iframe-link'\n\n// 预创建常用模块的日志器\nexport const log = {\n bridge: createDebug(`${NAMESPACE}:bridge`),\n channel: createDebug(`${NAMESPACE}:channel`),\n rpc: createDebug(`${NAMESPACE}:rpc`),\n event: createDebug(`${NAMESPACE}:event`),\n utils: createDebug(`${NAMESPACE}:utils`)\n}\n\n/**\n * 运行时启用 debug(用于 debug: true 配置)\n */\nexport function enableDebug() {\n createDebug.enable(`${NAMESPACE}:*`)\n}\n\n/**\n * 运行时禁用 debug\n */\nexport function disableDebug() {\n createDebug.disable()\n}\n\n/**\n * 检查 origin 是否可信\n */\nexport function isTrustedOrigin(origin: string, allowed: OriginPattern[]): boolean {\n const result = allowed.some(pattern => {\n if (pattern === '*') return true\n if (pattern instanceof RegExp) {\n const matcher = pattern.global || pattern.sticky\n ? new RegExp(pattern.source, pattern.flags)\n : pattern\n return matcher.test(origin)\n }\n return pattern === origin\n })\n\n log.utils('isTrustedOrigin: %s -> %s %O', origin, result ? '✓' : '✗', allowed.map(p => p.toString()))\n\n return result\n}\n\n/**\n * 生成 UUID(兼容旧环境)\n */\nfunction uuid(): string {\n if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n return crypto.randomUUID()\n }\n return Date.now().toString(36) + '-' + Math.random().toString(36).slice(2)\n}\n\n/**\n * RPC 远程调用管理\n */\nclass RPC {\n private destroyed = false\n private pending = new Map<string, {\n resolve: (value: any) => void\n reject: (error: Error) => void\n }>()\n\n constructor(\n private messenger: Messenger,\n private methods: Record<string, AnyFunction>\n ) {\n log.rpc('创建 RPC 管理器, methods: %O', Object.keys(methods))\n }\n\n call(name: string, params?: any): Promise<any> {\n if (this.destroyed) return Promise.reject(new Error('Destroyed'))\n\n return new Promise((resolve, reject) => {\n const id = uuid()\n log.rpc('发起调用: %s, id=%s, params=%O', name, id, params)\n this.pending.set(id, { resolve, reject })\n try {\n this.messenger.send({ type: 'CALL', id, method: name, params })\n } catch (error) {\n this.pending.delete(id)\n reject(error)\n }\n })\n }\n\n async execute(id: string, name: string, params: any) {\n log.rpc('执行方法: %s, id=%s, params=%O', name, id, params)\n\n // 避免原型链污染(如 valueOf、constructor 等)\n if (!Object.prototype.hasOwnProperty.call(this.methods, name)) {\n log.rpc('方法不存在: %s', name)\n this.messenger.send({ type: 'RESULT', id, error: `Method not found: ${name}` })\n return\n }\n\n try {\n const result = await this.methods[name](params)\n log.rpc('✓ 方法执行成功: %s, result=%O', name, result)\n this.messenger.send({ type: 'RESULT', id, result })\n } catch (error) {\n const message = error instanceof Error ? error.message : String(error)\n log.rpc('✗ 方法执行失败: %s, error=%s', name, message)\n this.messenger.send({ type: 'RESULT', id, error: message })\n }\n }\n\n resolve(id: string, result: any, error?: string) {\n const p = this.pending.get(id)\n if (!p) {\n log.rpc('未找到待处理的调用: %s', id)\n return\n }\n\n this.pending.delete(id)\n if (error !== undefined) {\n log.rpc('调用返回错误: id=%s, error=%s', id, error)\n p.reject(new Error(error))\n } else {\n log.rpc('调用返回成功: id=%s, result=%O', id, result)\n p.resolve(result)\n }\n }\n\n cleanup() {\n this.destroyed = true\n log.rpc('清理 RPC, pending=%d', this.pending.size)\n this.pending.forEach(({ reject }) => reject(new Error('Destroyed')))\n this.pending.clear()\n }\n}\n\nexport function createRPC(messenger: Messenger, methods: Record<string, AnyFunction>) {\n return new RPC(messenger, methods)\n}\n\n/**\n * 事件系统 - 发布订阅模式\n */\nexport function createEvent(messenger: Messenger) {\n const handlers = new Map<string, Set<(data: any) => void>>()\n\n return {\n on: (type: string, fn: (data: any) => void) => {\n if (!handlers.has(type)) handlers.set(type, new Set())\n handlers.get(type)!.add(fn)\n log.event('订阅事件: %s, handlers=%d', type, handlers.get(type)!.size)\n },\n\n off: (type: string, fn: (data: any) => void) => {\n handlers.get(type)?.delete(fn)\n log.event('取消订阅: %s', type)\n },\n\n emit: (type: string, data?: any) => {\n log.event('发送事件: %s, data=%O', type, data)\n messenger.send({ type: 'EVENT', eventType: type, data })\n },\n\n dispatch: (type: string, data: any) => {\n const set = handlers.get(type)\n const count = set ? set.size : 0\n log.event('分发事件: %s, handlers=%d, data=%O', type, count, data)\n if (set) set.forEach(fn => fn(data))\n },\n\n cleanup: () => {\n log.event('清理事件系统')\n handlers.clear()\n }\n }\n}\n","import type { Message, MessageHandler, OriginPattern } from './types'\nimport { isTrustedOrigin, log } from './utils'\n\n/**\n * 检查是否为有效消息格式(SDK 或原生)\n */\nfunction isValidMessage(data: any): boolean {\n const valid = data && typeof data === 'object' && (data.type || data.action)\n if (!valid && data) {\n log.bridge('无效消息格式: %O', data)\n }\n return valid\n}\n\n/**\n * 清理消息,移除不可序列化的内容(如函数)\n */\nfunction cleanMessage(message: Message): Message {\n return JSON.parse(JSON.stringify(message))\n}\n\n/**\n * 创建 postMessage 通信器\n * 本质:封装 window.postMessage 和 window.addEventListener('message')\n */\nexport function createMessenger(options: {\n isChild: boolean\n iframe?: HTMLIFrameElement\n origin?: string\n allowedOrigins?: OriginPattern[]\n}) {\n return options.isChild\n ? createChildMessenger(options.allowedOrigins!)\n : createParentMessenger(options.iframe!, options.origin!)\n}\n\n/**\n * 父应用通信器\n * 向 iframe 发送消息,接收 iframe 的消息\n */\nfunction createParentMessenger(iframe: HTMLIFrameElement, childOrigin: string) {\n let onMessage: MessageHandler | undefined\n let destroyed = false\n\n log.bridge('[Parent] 创建通信器, origin=%s, iframe=%s', childOrigin, iframe?.id || iframe?.src)\n\n const handleMessageEvent = (event: MessageEvent) => {\n log.bridge('[Parent] 收到消息: origin=%s, expected=%s, sourceMatch=%s, data=%O',\n event.origin, childOrigin, event.source === iframe.contentWindow, event.data)\n\n if (destroyed || !onMessage) {\n log.bridge('[Parent] 跳过: destroyed=%s, hasHandler=%s', destroyed, !!onMessage)\n return\n }\n if (event.origin !== childOrigin) {\n log.bridge('[Parent] origin 不匹配: %s !== %s', event.origin, childOrigin)\n return\n }\n if (event.source !== iframe.contentWindow) {\n log.bridge('[Parent] source 不是目标 iframe')\n return\n }\n if (!isValidMessage(event.data)) {\n return\n }\n\n log.bridge('[Parent] ✓ 消息验证通过: %O', event.data)\n onMessage(event.data)\n }\n\n const send = (message: Message) => {\n log.bridge('[Parent] 发送: %O -> %s', message, childOrigin)\n\n if (destroyed) return\n if (!iframe.contentWindow) throw new Error('Iframe not available')\n\n try {\n iframe.contentWindow.postMessage(cleanMessage(message), childOrigin)\n log.bridge('[Parent] ✓ 已发送: %s', message.type)\n } catch (e) {\n log.bridge('[Parent] ✗ 发送异常: %O', e)\n throw e\n }\n }\n\n return {\n isChild: false,\n init: (handler: MessageHandler) => {\n log.bridge('[Parent] 开始监听 message 事件')\n onMessage = handler\n window.addEventListener('message', handleMessageEvent)\n },\n send,\n destroy: () => {\n log.bridge('[Parent] 销毁通信器')\n if (destroyed) return\n window.removeEventListener('message', handleMessageEvent)\n onMessage = undefined\n destroyed = true\n }\n }\n}\n\n/**\n * 子应用通信器\n * 向父窗口发送消息,接收父窗口的消息\n */\nfunction createChildMessenger(allowedOrigins: OriginPattern[]) {\n let onMessage: MessageHandler | undefined\n let destroyed = false\n let parentOrigin: string | undefined\n\n log.bridge('[Child] 创建通信器, allowed=%O, inIframe=%s, origin=%s',\n allowedOrigins.map(o => o.toString()), window !== window.parent, window.location.origin)\n\n const handleMessageEvent = (event: MessageEvent) => {\n log.bridge('[Child] 收到消息: origin=%s, parentOrigin=%s, data=%O',\n event.origin, parentOrigin, event.data)\n\n if (destroyed || !onMessage) {\n log.bridge('[Child] 跳过: destroyed=%s, hasHandler=%s', destroyed, !!onMessage)\n return\n }\n\n if (event.source !== window.parent) {\n log.bridge('[Child] source 不是父窗口')\n return\n }\n\n const trusted = isTrustedOrigin(event.origin, allowedOrigins)\n if (!trusted) {\n log.bridge('[Child] origin 不可信: %s', event.origin)\n return\n }\n\n if (!isValidMessage(event.data)) {\n return\n }\n\n // 记录父窗口的 origin(首次通信时确定)\n if (!parentOrigin) {\n parentOrigin = event.origin\n log.bridge('[Child] 记录父窗口 origin: %s', parentOrigin)\n }\n\n log.bridge('[Child] ✓ 消息验证通过: %O', event.data)\n onMessage(event.data)\n }\n\n const send = (message: Message) => {\n // 父源未知时仅发送握手消息,业务消息不能使用通配目标。\n if (message.type !== 'READY' && !parentOrigin) return\n const targetOrigin = message.type === 'READY' ? '*' : parentOrigin!\n\n log.bridge('[Child] 发送: %O -> %s', message, targetOrigin)\n\n if (destroyed || !window.parent) {\n log.bridge('[Child] 发送失败: destroyed=%s, hasParent=%s', destroyed, window.parent !== window)\n return\n }\n\n try {\n window.parent.postMessage(cleanMessage(message), targetOrigin)\n log.bridge('[Child] ✓ 已发送: %s', message.type)\n } catch (e) {\n log.bridge('[Child] ✗ 发送异常: %O', e)\n throw e\n }\n }\n\n return {\n isChild: true,\n init: (handler: MessageHandler) => {\n log.bridge('[Child] 开始监听 message 事件')\n onMessage = handler\n window.addEventListener('message', handleMessageEvent)\n },\n send,\n destroy: () => {\n log.bridge('[Child] 销毁通信器')\n if (destroyed) return\n window.removeEventListener('message', handleMessageEvent)\n onMessage = undefined\n destroyed = true\n }\n }\n}\n","import type {\n IframeChannel,\n Message,\n NativeMessage,\n NativeResponse,\n ConnectToIframeOptions,\n ConnectToParentOptions,\n AnyFunction,\n} from \"./types\";\nimport { SDK_MESSAGE_TYPES, DEFAULT_ALLOWED_ORIGIN } from \"./types\";\nimport { createMessenger } from \"./channelBridge\";\nimport { createRPC, createEvent, log, enableDebug } from \"./utils\";\n\n/**\n * 检测是否为 SDK 协议消息(有 type 字段且是已知类型)\n */\nfunction isSDKMessage(message: any): message is Message {\n return (\n message &&\n typeof message === \"object\" &&\n \"type\" in message &&\n SDK_MESSAGE_TYPES.includes(message.type)\n );\n}\n\n/**\n * 检测是否为原生 postMessage 消息(有 action 字段,无 SDK type)\n */\nfunction isNativeMessage(message: any): message is NativeMessage {\n return (\n message &&\n typeof message === \"object\" &&\n \"action\" in message &&\n !isSDKMessage(message) &&\n !(\"success\" in message)\n ); // 排除响应消息\n}\n\n/**\n * 创建通信通道\n *\n * 握手流程(Handshake):\n * 1. 子应用加载完成后,发送 READY 消息\n * 2. 父应用收到 READY,回复 ACK 消息,并完成握手\n * 3. 子应用收到 ACK,完成握手\n * 4. 双方握手完成后,可以进行 RPC 调用和事件通信\n */\nfunction createChannel<T = any>(options: {\n messenger: ReturnType<typeof createMessenger>;\n methods?: Record<string, AnyFunction>;\n debug?: boolean;\n}): IframeChannel<T> {\n const { messenger, methods = {}, debug = false } = options;\n const role = messenger.isChild ? \"Child\" : \"Parent\";\n\n // 如果传入 debug: true,运行时启用日志\n if (debug) {\n enableDebug();\n }\n\n log.channel('[%s] 创建通信通道, methods=%O', role, Object.keys(methods));\n\n const rpc = createRPC(messenger, methods);\n const event = createEvent(messenger);\n\n // 握手状态:等待对方确认连接\n let resolveHandshake: ((remote: T) => void) | undefined;\n const handshakePromise = new Promise<T>((resolve) => {\n resolveHandshake = resolve;\n });\n\n // 开始监听消息\n messenger.init(handleMessage);\n log.channel('[%s] 消息监听已初始化', role);\n\n // 重试配置\n const RETRY_INTERVAL = 1000; // 重试间隔 1 秒\n const MAX_RETRIES = 5; // 最多重试 5 次\n let retryCount = 0;\n let retryTimer: ReturnType<typeof setInterval> | null = null;\n\n // 子应用主动发起握手(带重试机制)\n if (messenger.isChild) {\n const sendReady = () => {\n retryCount++;\n log.channel('[%s] 发送 READY (%d/%d)', role, retryCount, MAX_RETRIES);\n messenger.send({ type: \"READY\" });\n\n // 超过最大重试次数,停止重试\n if (retryCount >= MAX_RETRIES) {\n if (retryTimer) {\n clearInterval(retryTimer);\n retryTimer = null;\n }\n log.channel('[%s] ✗ 握手超时,已重试 %d 次', role, MAX_RETRIES);\n }\n };\n\n // 立即发送第一次\n sendReady();\n\n // 设置重试定时器\n retryTimer = setInterval(sendReady, RETRY_INTERVAL);\n } else {\n log.channel('[%s] 等待子应用 READY', role);\n }\n\n /**\n * 构建原生响应消息\n */\n function createNativeResponse(\n action: string,\n requestId?: string,\n result?: any,\n error?: string\n ): NativeResponse {\n return {\n type: \"__NATIVE_RESPONSE__\",\n action,\n requestId,\n success: error === undefined,\n result,\n error,\n };\n }\n\n /**\n * 处理收到的消息\n */\n function handleMessage(message: Message | NativeMessage) {\n log.channel('[%s] handleMessage: %O', role, message);\n if (isSDKMessage(message)) {\n handleSDKMessage(message);\n } else if (isNativeMessage(message)) {\n handleNativeMessage(message).catch(error => {\n log.channel('[%s] Native 响应发送失败: %O', role, error);\n });\n } else {\n log.channel('[%s] 未知消息类型,忽略', role);\n }\n }\n\n /**\n * 处理 SDK 协议消息\n */\n function handleSDKMessage(message: Message) {\n log.channel('[%s] SDK 消息: %s %O', role, message.type, message);\n\n switch (message.type) {\n case \"READY\":\n // 父应用收到子应用的 READY,回复 ACK 并完成握手\n if (!messenger.isChild) {\n log.channel('[%s] 收到 READY,回复 ACK', role);\n messenger.send({ type: \"ACK\" });\n finishHandshake();\n }\n break;\n case \"ACK\":\n // 子应用收到父应用的 ACK,完成握手\n if (messenger.isChild) {\n log.channel('[%s] 收到 ACK,握手完成', role);\n finishHandshake();\n }\n break;\n case \"CALL\":\n log.channel('[%s] RPC 调用: %s', role, message.method);\n rpc.execute(message.id!, message.method!, message.params).catch(error => {\n log.channel('[%s] RPC 响应发送失败: %O', role, error);\n });\n break;\n case \"RESULT\":\n log.channel('[%s] RPC 结果: id=%s', role, message.id);\n rpc.resolve(message.id!, message.result, message.error);\n break;\n case \"EVENT\":\n log.channel('[%s] 事件: %s', role, message.eventType);\n event.dispatch(message.eventType!, message.data);\n break;\n }\n }\n\n /**\n * 处理原生 postMessage 消息(给不使用 SDK 的子应用)\n */\n async function handleNativeMessage(message: NativeMessage) {\n const { action, data, requestId } = message;\n log.channel('[%s] Native 消息: %s', role, action);\n\n // 检查方法是否存在(避免原型链污染)\n if (!Object.prototype.hasOwnProperty.call(methods, action)) {\n messenger.send(\n createNativeResponse(\n action,\n requestId,\n undefined,\n `Method not found: ${action}`\n ) as any\n );\n return;\n }\n\n try {\n const result = await methods[action](data);\n messenger.send(createNativeResponse(action, requestId, result) as any);\n } catch (e) {\n const error = e instanceof Error ? e.message : String(e);\n messenger.send(\n createNativeResponse(action, requestId, undefined, error) as any\n );\n }\n }\n\n /**\n * 完成握手,创建远程调用代理\n */\n function finishHandshake() {\n if (!resolveHandshake) {\n log.channel('[%s] finishHandshake: 已完成,忽略', role);\n return;\n }\n\n // 停止重试定时器\n if (retryTimer) {\n clearInterval(retryTimer);\n retryTimer = null;\n }\n\n log.channel('[%s] ✓ 握手完成 (第 %d 次尝试)', role, retryCount);\n\n // 创建远程方法代理:remote.methodName(params) -> RPC 调用\n const remote = new Proxy(\n {},\n {\n get: (_, name) => {\n // 排除 Promise 相关属性,避免被当作 thenable\n if (name === \"then\" || name === \"catch\" || name === \"finally\") {\n return undefined;\n }\n return typeof name === \"string\"\n ? (params?: any) => rpc.call(name, params)\n : undefined;\n },\n }\n ) as T;\n\n resolveHandshake(remote);\n resolveHandshake = undefined;\n }\n\n return {\n promise: handshakePromise,\n on: event.on,\n off: event.off,\n emit: event.emit,\n destroy: () => {\n log.channel('[%s] 销毁通道', role);\n if (retryTimer) {\n clearInterval(retryTimer);\n retryTimer = null;\n }\n rpc.cleanup();\n event.cleanup();\n messenger.destroy();\n },\n };\n}\n\n/**\n * 父应用:连接到 iframe 子应用\n */\nexport function connectToIframe<T = any>(\n options: ConnectToIframeOptions\n): IframeChannel<T> {\n const { iframe, origin, methods, debug } = options;\n\n log.channel('connectToIframe: iframe=%s, origin=%s, debug=%s', iframe, origin, debug);\n\n const el =\n typeof iframe === \"string\"\n ? document.querySelector<HTMLIFrameElement>(iframe)\n : iframe;\n\n if (!el) {\n log.channel('✗ Iframe 未找到: %s', iframe);\n throw new Error(\"Iframe not found\");\n }\n if (!origin) {\n log.channel('✗ Origin 缺失');\n throw new Error(\"Origin is required\");\n }\n\n log.channel('创建父应用通道: origin=%s, src=%s', origin, el.src);\n const messenger = createMessenger({ isChild: false, iframe: el, origin });\n return createChannel<T>({ messenger, methods, debug });\n}\n\n/**\n * 子应用:连接到父窗口\n */\nexport function connectToParent<T = any>(\n options: ConnectToParentOptions = {}\n): IframeChannel<T> {\n const { allowedOrigins = [DEFAULT_ALLOWED_ORIGIN], methods, debug } = options;\n\n log.channel('connectToParent: allowed=%O, debug=%s', allowedOrigins.map(o => o.toString()), debug);\n\n const messenger = createMessenger({ isChild: true, allowedOrigins });\n return createChannel<T>({ messenger, methods, debug });\n}\n"],"mappings":"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","names":["createDebug","createDebug"]}
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# iframe-link
|
|
2
|
+
|
|
3
|
+
iframe と親ページの通信をシンプルに。
|
|
4
|
+
|
|
5
|
+
`window.postMessage` を使い、Promise ベースのリモート呼び出しとイベント通信を提供します。
|
|
6
|
+
|
|
7
|
+
[English](../README.md) · [简体中文](README.zh-CN.md) · 日本語
|
|
8
|
+
|
|
9
|
+
## 特長
|
|
10
|
+
|
|
11
|
+
`postMessage` はメッセージを送るだけで、リクエスト ID、Promise による応答、イベントの振り分け、相手側の準備完了を確実に確認する仕組みまでは提供しません。iframe ごとに同じ仕組みを作り直すのは手間がかかり、Origin 検証も見落としやすくなります。
|
|
12
|
+
|
|
13
|
+
この SDK は親ページと iframe を小さな双方向チャネルでつなぎます。メソッドの公開、リモート呼び出し、イベント送信に加え、READY/ACK ハンドシェイクで読み込み順の違いにも対応します。
|
|
14
|
+
|
|
15
|
+

|
|
16
|
+
|
|
17
|
+
## インストール
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
pnpm add iframe-link
|
|
21
|
+
# npm install iframe-link
|
|
22
|
+
# yarn add iframe-link
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## クイックスタート
|
|
26
|
+
|
|
27
|
+
### 親ページ
|
|
28
|
+
|
|
29
|
+
```ts
|
|
30
|
+
import { connectToIframe } from 'iframe-link'
|
|
31
|
+
|
|
32
|
+
type ChildApi = {
|
|
33
|
+
getStatus(input: { userId: string }): Promise<{ online: boolean }>
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
const channel = connectToIframe<ChildApi>({
|
|
37
|
+
iframe: '#profile-frame',
|
|
38
|
+
origin: 'https://child.example.com',
|
|
39
|
+
methods: {
|
|
40
|
+
getTheme: async () => ({ accent: '#3b82f6' })
|
|
41
|
+
}
|
|
42
|
+
})
|
|
43
|
+
|
|
44
|
+
channel.on('STATUS_CHANGED', console.log)
|
|
45
|
+
|
|
46
|
+
const child = await channel.promise
|
|
47
|
+
await child.getStatus({ userId: '42' })
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### 子ページ
|
|
51
|
+
|
|
52
|
+
```ts
|
|
53
|
+
import { connectToParent } from 'iframe-link'
|
|
54
|
+
|
|
55
|
+
type ParentApi = {
|
|
56
|
+
getTheme(): Promise<{ accent: string }>
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
const channel = connectToParent<ParentApi>({
|
|
60
|
+
allowedOrigins: ['https://app.example.com'],
|
|
61
|
+
methods: {
|
|
62
|
+
getStatus: async ({ userId }) => ({ userId, online: true })
|
|
63
|
+
}
|
|
64
|
+
})
|
|
65
|
+
|
|
66
|
+
const parent = await channel.promise
|
|
67
|
+
await parent.getTheme()
|
|
68
|
+
|
|
69
|
+
channel.emit('STATUS_CHANGED', { online: true })
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
iframe を削除するときは `channel.destroy()` を呼び出してください。
|
|
73
|
+
|
|
74
|
+
## API
|
|
75
|
+
|
|
76
|
+
`connectToIframe({ iframe, origin, methods })` は親ページから iframe へ接続し、`connectToParent({ allowedOrigins, methods })` は iframe から親ページへ接続します。
|
|
77
|
+
|
|
78
|
+
| メンバー | 用途 |
|
|
79
|
+
| --- | --- |
|
|
80
|
+
| `promise` | ハンドシェイク後、リモートメソッドのプロキシに解決されます。 |
|
|
81
|
+
| `on(type, handler)` | イベントを購読します。 |
|
|
82
|
+
| `off(type, handler)` | イベント購読を解除します。 |
|
|
83
|
+
| `emit(type, data?)` | 相手側へイベントを送信します。 |
|
|
84
|
+
| `destroy()` | リスナーを削除し、保留中の RPC を reject します。 |
|
|
85
|
+
|
|
86
|
+
`methods` で相手側にローカルメソッドを公開します。
|
|
87
|
+
|
|
88
|
+
## セキュリティと制限
|
|
89
|
+
|
|
90
|
+
- 本番環境では信頼できる Origin を明示し、ワイルドカードの Origin は設定しないでください。
|
|
91
|
+
- 親側は設定した Origin と送信元 iframe を検証します。子側は `allowedOrigins` を検証し、`event.source === window.parent` であることも確認します。
|
|
92
|
+
- 親ページの Origin が確認されるまでは、子側は READY のみを `targetOrigin: '*'` で送信します。`emit()` は `await channel.promise` の後に呼び出してください。子側が準備完了前に送信したイベントは無視されます。
|
|
93
|
+
- メッセージの値は JSON でシリアライズ可能である必要があります。各 RPC には、省略可能なペイロードを 1 つ渡せます。
|
|
94
|
+
- タイムアウトとキャンセルは内蔵していません。READY を 5 回送っても ACK が届かない場合、`promise` は pending のままです。
|
|
95
|
+
- SDK を使わない子ページから親側の公開メソッドを呼び出せますが、SDK のハンドシェイクは完了しません。
|
|
96
|
+
|
|
97
|
+
## コントリビューション
|
|
98
|
+
|
|
99
|
+
ローカル開発とテストについては、[貢献ガイド](https://github.com/yuukiLike/iframe-link/blob/main/docs/CONTRIBUTING.md)を参照してください。
|
|
100
|
+
|
|
101
|
+
## ライセンス
|
|
102
|
+
|
|
103
|
+
[MIT](../LICENSE) · [サードパーティの通知](THIRD_PARTY_NOTICES.md)
|
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
# iframe-link
|
|
2
|
+
|
|
3
|
+
让 iframe 与父页面之间的通信更简单。
|
|
4
|
+
|
|
5
|
+
基于 `window.postMessage`,提供 Promise 远程调用与事件通信。
|
|
6
|
+
|
|
7
|
+
[English](../README.md) · 简体中文 · [日本語](README.ja.md)
|
|
8
|
+
|
|
9
|
+
## 为什么使用
|
|
10
|
+
|
|
11
|
+
`postMessage` 只负责传递消息,并不会处理请求标识、Promise 响应、事件分发,也无法可靠确认另一端何时就绪。每个 iframe 都重复实现这些逻辑既繁琐,也容易遗漏 Origin 校验。
|
|
12
|
+
|
|
13
|
+
这个 SDK 将父页面与 iframe 连接成一个轻量的双向通道:暴露方法、等待远程调用、发送事件,并通过 READY/ACK 握手处理加载顺序差异。
|
|
14
|
+
|
|
15
|
+

|
|
16
|
+
|
|
17
|
+
## 安装
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
pnpm add iframe-link
|
|
21
|
+
# npm install iframe-link
|
|
22
|
+
# yarn add iframe-link
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## 快速开始
|
|
26
|
+
|
|
27
|
+
### 父页面
|
|
28
|
+
|
|
29
|
+
```ts
|
|
30
|
+
import { connectToIframe } from 'iframe-link'
|
|
31
|
+
|
|
32
|
+
type ChildApi = {
|
|
33
|
+
getStatus(input: { userId: string }): Promise<{ online: boolean }>
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
const channel = connectToIframe<ChildApi>({
|
|
37
|
+
iframe: '#profile-frame',
|
|
38
|
+
origin: 'https://child.example.com',
|
|
39
|
+
methods: {
|
|
40
|
+
getTheme: async () => ({ accent: '#3b82f6' })
|
|
41
|
+
}
|
|
42
|
+
})
|
|
43
|
+
|
|
44
|
+
channel.on('STATUS_CHANGED', console.log)
|
|
45
|
+
|
|
46
|
+
const child = await channel.promise
|
|
47
|
+
await child.getStatus({ userId: '42' })
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### 子页面
|
|
51
|
+
|
|
52
|
+
```ts
|
|
53
|
+
import { connectToParent } from 'iframe-link'
|
|
54
|
+
|
|
55
|
+
type ParentApi = {
|
|
56
|
+
getTheme(): Promise<{ accent: string }>
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
const channel = connectToParent<ParentApi>({
|
|
60
|
+
allowedOrigins: ['https://app.example.com'],
|
|
61
|
+
methods: {
|
|
62
|
+
getStatus: async ({ userId }) => ({ userId, online: true })
|
|
63
|
+
}
|
|
64
|
+
})
|
|
65
|
+
|
|
66
|
+
const parent = await channel.promise
|
|
67
|
+
await parent.getTheme()
|
|
68
|
+
|
|
69
|
+
channel.emit('STATUS_CHANGED', { online: true })
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
移除 iframe 时,请调用 `channel.destroy()`。
|
|
73
|
+
|
|
74
|
+
## API
|
|
75
|
+
|
|
76
|
+
`connectToIframe({ iframe, origin, methods })` 让父页面连接 iframe,`connectToParent({ allowedOrigins, methods })` 让 iframe 连接父页面。
|
|
77
|
+
|
|
78
|
+
| 成员 | 用途 |
|
|
79
|
+
| --- | --- |
|
|
80
|
+
| `promise` | 握手完成后解析为远程方法代理。 |
|
|
81
|
+
| `on(type, handler)` | 监听事件。 |
|
|
82
|
+
| `off(type, handler)` | 移除事件监听。 |
|
|
83
|
+
| `emit(type, data?)` | 向另一端发送事件。 |
|
|
84
|
+
| `destroy()` | 移除监听,并拒绝仍在等待的 RPC。 |
|
|
85
|
+
|
|
86
|
+
`methods` 用于向另一端暴露本地方法。
|
|
87
|
+
|
|
88
|
+
## 安全与限制
|
|
89
|
+
|
|
90
|
+
- 生产环境请配置明确可信的 Origin,不要配置通配 Origin。
|
|
91
|
+
- 父页面会校验配置的 Origin 与来源 iframe;子页面会校验 `allowedOrigins`,并要求 `event.source === window.parent`。
|
|
92
|
+
- 确认父页面 Origin 之前,子页面只发送 READY 消息,使用 `targetOrigin: '*'`。请在 `await channel.promise` 后调用 `emit()`;子页面在就绪前发送的事件会被忽略。
|
|
93
|
+
- 消息内容必须可被 JSON 序列化;每次 RPC 只接收一个可选参数。
|
|
94
|
+
- 当前没有内置的超时或取消机制。连续 5 次 READY 未收到 ACK 时,`promise` 会保持 pending。
|
|
95
|
+
- 未使用 SDK 的子页面可以调用 SDK 父页面暴露的方法,但不会完成 SDK 握手。
|
|
96
|
+
|
|
97
|
+
## 贡献
|
|
98
|
+
|
|
99
|
+
本地开发与测试请参阅[贡献指南](https://github.com/yuukiLike/iframe-link/blob/main/docs/CONTRIBUTING.md)。
|
|
100
|
+
|
|
101
|
+
## 许可证
|
|
102
|
+
|
|
103
|
+
[MIT](../LICENSE) · [第三方声明](THIRD_PARTY_NOTICES.md)
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
# Third-party notices
|
|
2
|
+
|
|
3
|
+
`iframe-link` bundles the following MIT-licensed packages in its browser build.
|
|
4
|
+
|
|
5
|
+
## debug
|
|
6
|
+
|
|
7
|
+
Copyright (c) 2014-2017 TJ Holowaychuk <tj@vision-media.ca>
|
|
8
|
+
Copyright (c) 2018-2021 Josh Junon
|
|
9
|
+
|
|
10
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy of this software
|
|
11
|
+
and associated documentation files (the "Software"), to deal in the Software without restriction,
|
|
12
|
+
including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense,
|
|
13
|
+
and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so,
|
|
14
|
+
subject to the following conditions:
|
|
15
|
+
|
|
16
|
+
The above copyright notice and this permission notice shall be included in all copies or substantial
|
|
17
|
+
portions of the Software.
|
|
18
|
+
|
|
19
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
|
|
20
|
+
LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
|
21
|
+
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
|
|
22
|
+
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
|
23
|
+
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
24
|
+
|
|
25
|
+
## ms
|
|
26
|
+
|
|
27
|
+
Copyright (c) 2020 Vercel, Inc.
|
|
28
|
+
|
|
29
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
30
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
31
|
+
in the Software without restriction, including without limitation the rights
|
|
32
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
33
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
34
|
+
furnished to do so, subject to the following conditions:
|
|
35
|
+
|
|
36
|
+
The above copyright notice and this permission notice shall be included in all
|
|
37
|
+
copies or substantial portions of the Software.
|
|
38
|
+
|
|
39
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
40
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
41
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
42
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
43
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
44
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
45
|
+
SOFTWARE.
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
package/package.json
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "iframe-link",
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "Simple communication between an iframe and its parent. Promise-based calls and events over postMessage.",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"iframe",
|
|
7
|
+
"iframe-rpc",
|
|
8
|
+
"postmessage",
|
|
9
|
+
"postmessage-rpc",
|
|
10
|
+
"rpc",
|
|
11
|
+
"events",
|
|
12
|
+
"cross-origin",
|
|
13
|
+
"handshake",
|
|
14
|
+
"typescript"
|
|
15
|
+
],
|
|
16
|
+
"author": "yuukiLike <YuukiJyoudai@outlook.com>",
|
|
17
|
+
"license": "MIT",
|
|
18
|
+
"repository": {
|
|
19
|
+
"type": "git",
|
|
20
|
+
"url": "git+https://github.com/yuukiLike/iframe-link.git"
|
|
21
|
+
},
|
|
22
|
+
"bugs": {
|
|
23
|
+
"url": "https://github.com/yuukiLike/iframe-link/issues"
|
|
24
|
+
},
|
|
25
|
+
"homepage": "https://github.com/yuukiLike/iframe-link#readme",
|
|
26
|
+
"type": "module",
|
|
27
|
+
"sideEffects": false,
|
|
28
|
+
"main": "./dist/index.cjs",
|
|
29
|
+
"module": "./dist/index.js",
|
|
30
|
+
"types": "./dist/index.d.ts",
|
|
31
|
+
"exports": {
|
|
32
|
+
".": {
|
|
33
|
+
"import": {
|
|
34
|
+
"types": "./dist/index.d.ts",
|
|
35
|
+
"default": "./dist/index.js"
|
|
36
|
+
},
|
|
37
|
+
"require": {
|
|
38
|
+
"types": "./dist/index.d.cts",
|
|
39
|
+
"default": "./dist/index.cjs"
|
|
40
|
+
}
|
|
41
|
+
}
|
|
42
|
+
},
|
|
43
|
+
"files": [
|
|
44
|
+
"dist",
|
|
45
|
+
"docs/README.zh-CN.md",
|
|
46
|
+
"docs/README.ja.md",
|
|
47
|
+
"docs/THIRD_PARTY_NOTICES.md",
|
|
48
|
+
"docs/assets"
|
|
49
|
+
],
|
|
50
|
+
"publishConfig": {
|
|
51
|
+
"registry": "https://registry.npmjs.org/",
|
|
52
|
+
"access": "public"
|
|
53
|
+
},
|
|
54
|
+
"devDependencies": {
|
|
55
|
+
"@playwright/test": "^1.40.0",
|
|
56
|
+
"@types/debug": "^4.1.12",
|
|
57
|
+
"@types/node": "^25.0.6",
|
|
58
|
+
"@vitest/coverage-v8": "^1.0.0",
|
|
59
|
+
"concurrently": "^9.2.1",
|
|
60
|
+
"debug": "^4.4.3",
|
|
61
|
+
"happy-dom": "^12.0.0",
|
|
62
|
+
"live-server": "^1.2.2",
|
|
63
|
+
"serve": "^14.0.0",
|
|
64
|
+
"tsup": "^8.0.0",
|
|
65
|
+
"typescript": "^5.3.0",
|
|
66
|
+
"vitest": "^1.0.0"
|
|
67
|
+
},
|
|
68
|
+
"scripts": {
|
|
69
|
+
"dev": "concurrently \"tsup --config config/tsup.config.ts --watch\" \"live-server --port=3000 --open=/examples/index.html --wait=1000\"",
|
|
70
|
+
"build": "tsup --config config/tsup.config.ts",
|
|
71
|
+
"demo": "pnpm run build && live-server --port=3000 --open=/examples/index.html",
|
|
72
|
+
"test": "vitest run --config config/vitest.config.ts",
|
|
73
|
+
"test:watch": "vitest --config config/vitest.config.ts",
|
|
74
|
+
"test:coverage": "vitest run --config config/vitest.config.ts --coverage",
|
|
75
|
+
"test:e2e": "pnpm run build && playwright test --config config/playwright.config.ts",
|
|
76
|
+
"test:e2e:ui": "playwright test --config config/playwright.config.ts --ui",
|
|
77
|
+
"test:all": "pnpm run test && pnpm run test:e2e"
|
|
78
|
+
}
|
|
79
|
+
}
|