咨询：PyScript项目中js包的文档获取途径

我完全懂你入门PyScript时找不到js包文档的困惑——这个包其实是Pyodide（PyScript的底层运行环境）自动生成的Python-JS桥接模块，专门用来让Python直接调用浏览器的Web API，它没有单独的官方文档，因为它直接映射了浏览器本身的API体系。

为什么js包没有独立文档？ #

• js模块是Pyodide动态生成的，它把浏览器的全局对象（比如document、window）和所有可用的Web API直接暴露给Python，相当于Python和JS之间的“翻译器”。
• 你可以把js.document理解成浏览器里window.document的Python版本，它的用法和JS里的API完全一致，所以直接参考浏览器的Web API文档（比如MDN的标准文档）就足够了。

你的示例代码拆解 #

看你给出的这段代码：

import asyncio
from js import document, FileReader
from pyodide import create_proxy

• from js import document：导入浏览器的document对象，这是DOM操作的核心入口，比如查找页面元素、修改内容、绑定事件等，用法和JS里的document完全对应，比如document.getElementById("print_output")。
• from js import FileReader：导入浏览器的FileReader API，用来处理前端文件读取逻辑，和JS中的FileReader功能、调用逻辑一致，只是用Python语法来写。
• create_proxy：这是Pyodide提供的工具，用来把Python函数转换成JS能识别的回调函数，比如处理文件读取完成、按钮点击这类异步事件时必须用到它。

高效使用js包的小技巧 #

• 想用哪个Web API，直接从js导入对应的对象/类：比如要操作浏览器窗口就from js import window，要发起网络请求就from js import fetch。
• 参数和返回值会自动在Python和JS类型间转换：比如JS字符串会变成Python的str，JS数组会变成Python的list，反之亦然。
• 处理异步操作时，结合asyncio或者create_proxy：比如监听FileReader的load事件，就可以用create_proxy把Python函数包装成JS回调。

给你举个简单的DOM操作实战例子：

from js import document

# 找到页面元素并修改内容
output_elem = document.getElementById("print_output")
output_elem.textContent = "Hello from PyScript DOM操作!"

内容的提问来源于stack exchange，提问作者Joshua Khondowe