PDF 导出功能将当前页面打印为 PDF 文件，支持纸张尺寸、页边距和页面范围等参数。
page.save_pdf(path=None, **kwargs)将当前页面保存为 PDF。支持 A4/Letter 等纸张尺寸和页边距设置。
| 参数 | 说明 |
|---|---|
| path | 可选，PDF 保存路径。不传则返回 bytes。 |
| orientation | 'portrait'（纵向）或 'landscape'（横向）。 |
| scale | 缩放比例，默认 1.0。 |
| page_ranges | 页面范围，如 '1-3'。 |
from ruyipage import launch
page = launch()
try:
page.get("https://example.com")
# 保存为 PDF 文件
page.save_pdf(path="output.pdf")
print("PDF 已保存")
# 横向布局 + 返回 bytes
pdf_bytes = page.save_pdf(orientation="landscape")
print(f"PDF 大小: {len(pdf_bytes)} bytes")
finally:
page.quit()集中说明 save_pdf 的参数覆盖能力。
源码文件：app/content/ruyipage_examples/19_pdf_printing.py · 仓库：19_pdf_printing.py
# =============================
# RuyiPage 示例注释版
# 标题: PDF 打印：纸张尺寸、方向、边距、页范围与导出数据
# 说明: 集中说明 save_pdf 的参数覆盖能力。
# 你会学到:
# 1. 基础 PDF 导出
# 2. A4 纸张和背景打印
# 3. 横向打印与缩放
# 4. 自定义页边距和页范围
# 5. 获取 PDF bytes 与 base64
# 相关 API: page.save_pdf, page.pdf
# =============================
# -*- coding: utf-8 -*-
"""示例19: PDF 打印（完整参数覆盖）"""
import io
import os
import sys
if sys.platform == "win32":
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8")
sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding="utf-8")
sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
from ruyipage import FirefoxOptions, FirefoxPage
def _size_of(path):
return os.path.getsize(path) if os.path.exists(path) else 0
def test_pdf_printing():
print("=" * 60)
print("测试19: PDF打印功能")
print("=" * 60)
opts = FirefoxOptions()
opts.headless(False)
page = FirefoxPage(opts)
try:
test_page = os.path.join(
os.path.dirname(__file__), "test_pages", "test_page.html"
)
test_url = "file:///" + os.path.abspath(test_page).replace("\\", "/")
page.get(test_url)
page.wait(1)
output_dir = os.path.join(os.path.dirname(__file__), "output", "pdf")
os.makedirs(output_dir, exist_ok=True)
# 1) 基本打印
print("\n1. 基本PDF打印:")
p1 = os.path.join(output_dir, "basic.pdf")
page.save_pdf(p1)
print(f" ✓ 已保存: {p1} ({_size_of(p1)} bytes)")
# 2) A4 + 背景
print("\n2. A4 + 背景:")
p2 = os.path.join(output_dir, "a4_bg.pdf")
page.save_pdf(
p2,
page={"width": 21.0, "height": 29.7},
background=True,
)
print(f" ✓ 已保存: {p2} ({_size_of(p2)} bytes)")
# 3) 横向 + 缩放 + 页边距
print("\n3. 横向 + 缩放 + 页边距:")
p3 = os.path.join(output_dir, "landscape_scaled.pdf")
page.save_pdf(
p3,
orientation="landscape",
scale=0.9,
margin={
"top": 1.2,
"bottom": 1.2,
"left": 1.0,
"right": 1.0,
},
)
print(f" ✓ 已保存: {p3} ({_size_of(p3)} bytes)")
# 4) 指定页范围 + shrinkToFit
print("\n4. 指定页范围 + shrinkToFit:")
p4 = os.path.join(output_dir, "page_ranges_shrink.pdf")
page.save_pdf(
p4,
page_ranges=["1-2"],
shrink_to_fit=True,
)
print(f" ✓ 已保存: {p4} ({_size_of(p4)} bytes)")
# 5) 获取 bytes/base64
print("\n5. 获取 bytes / base64:")
pdf_bytes = page.pdf(page_ranges=["1"])
pdf_b64 = (
__import__("base64")
.b64encode(page.pdf(shrink_to_fit=False))
.decode("ascii")
)
print(f" bytes长度: {len(pdf_bytes)}")
print(f" base64长度: {len(pdf_b64)}")
if not (len(pdf_bytes) > 100 and len(pdf_b64) > 100):
raise RuntimeError("PDF 输出长度异常")
print("\n" + "=" * 60)
print("✓ 所有PDF打印测试通过！")
print(f"PDF保存在: {output_dir}")
print("=" * 60)
except Exception as e:
print(f"\n✗ 测试失败: {e}")
import traceback
traceback.print_exc()
finally:
page.wait(1)
page.quit()
if __name__ == "__main__":
test_pdf_printing()
覆盖最基础的页面访问、前进后退和保存 HTML/PDF。
源码文件：app/content/ruyipage_examples/01_basic_navigation.py · 仓库：01_basic_navigation.py
# =============================
# RuyiPage 示例注释版
# 标题: 基础导航与页面保存
# 说明: 覆盖最基础的页面访问、前进后退和保存 HTML/PDF。
# 你会学到:
# 1. 打开本地文件页面和外部页面
# 2. 读取标题、URL 和 HTML 源码
# 3. 执行前进、后退和刷新
# 4. 保存 HTML 与 PDF
# 相关 API: FirefoxPage, FirefoxOptions, page.get, page.title, page.url, page.html, page.back, page.forward
# =============================
# -*- coding: utf-8 -*-
"""
示例1: 基础导航和页面操作
测试功能：
- 创建浏览器实例
- 页面导航
- 获取标题、URL
- 前进、后退、刷新
- 页面保存
"""
import os
import sys
import io
# 设置控制台输出编码为UTF-8（Windows兼容）
if sys.platform == 'win32':
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')
sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8')
sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..'))
from ruyipage import FirefoxPage, FirefoxOptions
def test_basic_navigation():
"""测试基础导航功能"""
print("=" * 60)
print("测试1: 基础导航和页面操作")
print("=" * 60)
# 创建浏览器实例
opts = FirefoxOptions()
opts.headless(False) # 显示浏览器窗口
page = FirefoxPage(opts)
try:
# 1. 导航到测试页面
test_page = os.path.join(os.path.dirname(__file__), 'test_pages', 'test_page.html')
test_url = 'file:///' + os.path.abspath(test_page).replace('\\', '/')
print(f"\n1. 导航到测试页面: {test_url}")
page.get(test_url)
print(f" ✓ 页面加载成功")
# 2. 获取页面信息
print(f"\n2. 获取页面信息:")
print(f" 标题: {page.title}")
print(f" URL: {page.url}")
print(f" HTML长度: {len(page.html)} 字符")
# 3. 导航到其他页面
print(f"\n3. 导航到其他页面:")
page.get('https://www.example.com')
print(f" 当前标题: {page.title}")
print(f" 当前URL: {page.url}")
# 4. 后退
print(f"\n4. 后退到上一页:")
page.back()
page.wait(1)
print(f" 当前标题: {page.title}")
# 5. 前进
print(f"\n5. 前进到下一页:")
page.forward()
page.wait(1)
print(f" 当前标题: {page.title}")
# 6. 刷新页面
print(f"\n6. 刷新页面:")
page.refresh()
page.wait(1)
print(f" ✓ 页面已刷新")
# 7. 保存页面
print(f"\n7. 保存页面:")
save_dir = os.path.join(os.path.dirname(__file__), 'output')
os.makedirs(save_dir, exist_ok=True)
# 保存为HTML
html_path = page.save(path=save_dir, name='example_page', as_pdf=False)
print(f" HTML已保存: {html_path}")
# 保存为PDF
pdf_path = page.save(path=save_dir, name='example_page', as_pdf=True)
print(f" PDF已保存: {pdf_path}")
print("\n" + "=" * 60)
print("✓ 所有基础导航测试通过！")
print("=" * 60)
except Exception as e:
print(f"\n✗ 测试失败: {e}")
import traceback
traceback.print_exc()
finally:
# 关闭浏览器
page.wait(2)
page.quit()
if __name__ == '__main__':
test_basic_navigation()