page2pdf_server 1.0.2 → 1.1.1

package/src/types/request/config.ts

@@ -1,95 +1,3 @@
-/**一次作业的模型配置；
- * 若本对象为空{}的话：默认是按照修改时间的顺序简易模式地合并当前工作目录的所有pdf文件。
- * 若某个URL不正常的，很可能无法触发页面加载完成，导致作业一致无法继续下去，大大超出预期执行时间。URL对应网页若不是一次性加载完成还会陆陆续续修改内容的就是这种情况造成死等长时间没结果。
- * */
-export interface ConfigRoot<T> {
-  //是否生成合并的pdf：正常情况下， 默认=true进行files输出pdf全部做合并的。 除非files[]也是空的情形。
-  //但若需对任一个URL叠加新页眉页脚的，merge就不能=false的。
-  merge?: boolean;
-  //重定义 合并的pdf文件名, 否则默认名。不需要加 .pdf结尾的
-  name: string;
-  //双面打印的合并输出pdf， 默认=true, 表示合并输出的pdf考虑到双面打印的页眉页脚的布局差异化情况了。
-  doubleSide?: boolean;
-  //统一一整份应该用的页眉页脚
-  //假如files[]里面有些url自己也定义了lay{localSumNo=false}的页眉页脚输出配置，只能忽略掉它们，页码总数不算他们的，页码连续编号也不算它们的占坑:最好都挪到最后面。
-  lay?: HeadFooter;
-  //每一个独立的pdf生成：
-  files: [T];
-
-  //共用一个浏览器窗口 默认=true
-  singleTab?: boolean;
-  //自动关闭浏览器窗口 默认=false
-  closeTab?: boolean;
-
-  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
-  headerTemplate?: string;
-  footerTemplate?: string;
-  headerTemplateL?: string;
-  footerTemplateL?: string;
-  //第二阶段页眉页脚生成的浏览器执行窗口的targetId,不可配置。
-  CDPtab?: string;
-}
-
-/**等待输出的每个独立文件:URL，这些文件可能要合并。
- * @前提条件 是：每个url独立文件生成的PDF，它的纸张大小必须保证同一个大小尺寸， size: 必须唯一，但是纸张方向在某些约束条件中可以横屏竖屏混合的。
- * 物理打印机：纸张适配，横竖方向还好能自动调节，size 真实打印纸张尺寸就不好自动处理, 不一样的尺寸?最好拆解pdf。
- * 标准纸张大小的：静态html内CSS定义横竖纸张方向混合的：用reverseRanges参数设置部分纸张反转纸张方向，pageRanges=''的前提下：配置比如'1-5, 8, 11-13'和landscape参数设置相反方向。
- * */
-export interface FileTransform {
-  //[必须配置的] 特殊的前缀是 http:// https:// 没有这俩个的都是本地工作目录的文件全名(含文件类型后缀 *.pdf *.*)。
-  //任意的本地文件类型，只要可以被Chrome装载并能够支持打印预览的都可以。http打头的网页必须确保已经登录了，也就是遗留cockies token,不能要求交互登录。本地文件不能要求输入口令。
-  //不支持*.xls *.doc文件；不支持的格式实际在浏览器拖拽窗口后会蜕变成了下载形式的。被加密的文件必须提前解密,网站登录需提前解决。
-  //【特殊问题】若URL网页动态化太离谱，周期性地不间断地更新页面,没法触发加载结束事件的，只能手动在浏览器查看打印另存pdf，然后把手动生成pdf合并进来。Tab切换会主动刷新的也不触发。
-  url: string;
-  //输出本地工作目录的文件名， 不需要加 .pdf结尾的 【注意】如果out为空表示url是pdf的没必要转换的要直接进入合并步骤。
-  //【特别】必须配置唯一性 的本地 工作目录的文件名，同名的被直接覆盖了。
-  out: string;
-
-  //是否汇总合并阶段省略本url，不合并进去，那就是单独独立的pdf输出了。默认=true是合并进去。 和是否打印页眉页脚或页眉统计页数没有绝对关系的。
-  merge?: boolean;
-
-  //默认取值都是=true; 第一阶段不会生成页眉页脚的，汇总第二阶段这个参数才会生效！
-  //这里配置displayHeaderFooter优先级最高。
-  //页眉页脚如何分开控制是否打印的： 可以把lay{head，foot}其中一个配置串给设置为null,null就代表不输出。例如head=null就不输出页眉，但是页脚照旧打印的。本url的配置优先于汇总pdf配置。
-  //若ConfigRoot<T>.merge=false那么必然导致FileTransform.merge强制=false，每个独立pdf页码独立的独立都从1开始编号吗还需要打印吗，页眉页脚需要打印吗？这个情况页眉页脚打印的默认值改成false;
-  displayHeaderFooter: boolean;
-
-  //【特别注意】frNo 可能和 headFrom 配置矛盾。
-  //本url打印：从第几页才开始页眉页脚的打印，#页码同样也是在这之后才可能计数和编号!。默认值headFrom=1：就是第一页就开始打印页眉页脚的。
-  //书本封面页情况的。这个参数有最高优先级。 【注意】和frNo设置相互影响, 没有页眉页脚就失去页码意义了。若真的违反了可能页码不能连续输出的，被隐藏了页码缘故。
-  headFrom?: number;
-  //本url打印后，从本URL输出的第几页开始才进行的页码序号的顺序输出的，前面几页不打印页码(但是页眉页脚要打印)。默认值=1全部都打页码。若frNo=0全部不打页码的。
-  //假如displayHeaderFooter=false也即页码无法显示出来的情况：请申明frNo=0; 不然默认是连续页码的，不打印的也有占用页码的隐藏的连续数字啊。
-  //注意若有配置 headFrom 的要协调好。
-  frNo?: number;
-
-  //是否对页码支持连续编号：  Continuous numbering 是跟随汇总合并的页码 基数合计。【注意】本配置单个url范围，单个url不能混合本地页码和全局页面两种！
-  //统计页数是否本URL独立自己范围之内进行的汇总计数。比如书本目录有多页的可以独立统计页码序号以及总页数的。默认=false;
-  localSumNo?: boolean;
-  //本url对应的部分应该用的页眉页脚，覆盖掉合并pdf的相对应设置。页面上只能支持输出一次页眉页脚，不重叠做输出。
-  //若lay{localSumNo=false}只能固定支持本url自己内部的页码统计顺序编号，不考虑合并pdf总页数带来的影响的。 还是？预设其它部分的页数统计总数之后？再做偏移页码编写？
-  lay: PartHeadFooter;
-  //前端声明本url在第一阶段打印输出后，生成的pdf应该有几页。 count没有设置的救不会做异常检查的。不是第二阶段的计数：双面情况可能增加空白页
-  count?: number;
-  //双面打印的 默认=true, 表示独立分开输出的pdf文件的：考虑到双面打印的页眉页脚的布局差异化情况了。
-  //合并输出merge=true的情况：该参数无效，要看汇总配置的哪一个 # ConfigRoot<T>{ doubleSide： }字段。
-  doubleSide: boolean;
-  //双面打印的情形：必须确保本URL的第一个页是正好右手边(书本翻页的奇数号页码)开始的位置页。正常第一个URL首页面就是双面打印的右手边位置页；默认值=false不必确保.
-  rightHand: boolean;
-
-  //页码是罗马数字；论文目录需要的；默认=false阿拉伯数字。"I","II","III","IV","V","VI","VII","VIII","IX" "X"XI"XII"表盘符号
-  //roman只能针对本URL启用；数字转换范围最大支持1到12，超过了便改阿拉伯数字，且只针对pageNumber有效, totalPages不会采用。
-  roman?: boolean;
-
-  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
-  headerTemplate?: string;
-  footerTemplate?: string;
-  headerTemplateL?: string;
-  footerTemplateL?: string;
-  //第一阶段Url转pdf的浏览器执行窗口的targetId,不可配置。
-  CDPtab?: string;
-}
-
 /*看 Page.printToPDF（）文档说明的： 可以使用的注入参数:
   date: formatted print date
   title: document title
@@ -99,7 +7,8 @@ export interface FileTransform {
   For example, <span class=title></span> would generate span containing the title.
 */
 
-/**页眉页脚声明；前提条件是页眉页脚htm描述里面：不应该把-NOT_DISPLAY- ${pageNumber} ${totalPages}这三个保留字字符串当作普通文字输出的。
+/**页眉页脚声明；前提条件是页眉页脚htm描述里面： 上一个版本保留字 ${pageNumber} ${totalPages}
+ * 不应该把 -NOT_DISPLAY-  ~pageNumber~  ~totalPages~  这三个 保留字字符串当作普通文字输出的。
  * 前端发送数据包时刻，页眉页脚的脚本需要在 HTML转JSON 工具网站 进行转换处理后的；网站地址  https://uutool.cn/html2json/ 转换htm模板后是数组[string]
  * 实际上也就进行拆分多行字符串拼接数组，还有把html语法中的 ""引号 进行转义 style="position: 变成 style=\\\"position: 处置的。
  * */
@@ -112,10 +21,11 @@ export interface HeadFooter {
   //双面打印：右手边位置的,或单面打印使用
   foot?: string | string[] | null; //实际前端发过来却是[string]的也可以啊。
   /**可注入3个参数"特殊标记字符串"如下： 服务端依据参数来对注入的html进行修改的。
-   * ${pageNumber}
-   * ${totalPages}
-   * -NOT_DISPLAY-
-   * 这三个分别代表 页码 总页数 以及页码<div style=""></div>中的可替代占位位置。-NOT_DISPLAY-在后端要直接替代成display:none;的CSS标记字符串！其它2个替换成数字号码。
+   * ~pageNumber~
+   * ~totalPages~
+   * -NOT_DISPLAY- 有页码才能显示，无页码就隐藏的标记。
+   * 这三个分别代表 页码 总页数 以及页码<div style=""></div>中的可替代占位位置。
+   * 其它2个替换成数字号码。
    * */
   //双面打印：左手边位置的
   headL?: string | string[] | null;

package/src/types/request/home.ts

@@ -1,3 +1,3 @@
-import CONFIG from "@/configEnv";
+import CONFIG from "../../configEnv";
 
 export type getAppInfoQuery = `${Lowercase<keyof typeof CONFIG.APP>}`;

package/src/types.d.ts

@@ -0,0 +1,97 @@
+import { HeadFooter, PartHeadFooter } from "@/types/request/config";
+
+/**一次作业的模型配置；
+ * 若本对象为空{}的话：默认是按照修改时间的顺序简易模式地合并当前工作目录的所有pdf文件。
+ * 若某个URL不正常的，很可能无法触发页面加载完成，导致作业一致无法继续下去，大大超出预期执行时间。URL对应网页若不是一次性加载完成还会陆陆续续修改内容的就是这种情况造成死等长时间没结果。
+ * */
+export interface ConfigRoot<T> {
+  //是否生成合并的pdf：正常情况下， 默认=true进行files输出pdf全部做合并的。 除非files[]也是空的情形。
+  //但若需对任一个URL叠加新页眉页脚的，merge就不能=false的。
+  merge?: boolean;
+  //重定义 合并的pdf文件名, 否则默认名。不需要加 .pdf结尾的
+  name: string;
+  //双面打印的合并输出pdf， 默认=true, 表示合并输出的pdf考虑到双面打印的页眉页脚的布局差异化情况了。
+  doubleSide?: boolean;
+  //统一一整份应该用的页眉页脚
+  //假如files[]里面有些url自己也定义了lay{localSumNo=false}的页眉页脚输出配置，只能忽略掉它们，页码总数不算他们的，页码连续编号也不算它们的占坑:最好都挪到最后面。
+  lay?: HeadFooter;
+  //每一个独立的pdf生成：
+  files: [T];
+
+  //共用一个浏览器窗口 默认=true
+  singleTab?: boolean;
+  //自动关闭浏览器窗口 默认=false
+  closeTab?: boolean;
+
+  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
+  headerTemplate?: string;
+  footerTemplate?: string;
+  headerTemplateL?: string;
+  footerTemplateL?: string;
+  //第二阶段页眉页脚生成的浏览器执行窗口的targetId,不可配置。
+  CDPtab?: string;
+}
+
+// types.d.ts
+/**等待输出的每个独立文件:URL，这些文件可能要合并。
+ * @前提条件 是：每个url独立文件生成的PDF，它的纸张大小必须保证同一个大小尺寸， size: 必须唯一，但是纸张方向在某些约束条件中可以横屏竖屏混合的。
+ * 物理打印机：纸张适配，横竖方向还好能自动调节，size 真实打印纸张尺寸就不好自动处理, 不一样的尺寸?最好拆解pdf。
+ * 标准纸张大小的：静态html内CSS定义横竖纸张方向混合的：用reverseRanges参数设置部分纸张反转纸张方向，pageRanges=''的前提下：配置比如'1-5, 8, 11-13'和landscape参数设置相反方向。
+ * */
+export interface FileTransform {
+  //[必须配置的] 特殊的前缀是 http:// https:// 没有这俩个的都是本地工作目录的文件全名(含文件类型后缀 *.pdf *.*)。
+  //任意的本地文件类型，只要可以被Chrome装载并能够支持打印预览的都可以。http打头的网页必须确保已经登录了，也就是遗留cockies token,不能要求交互登录。本地文件不能要求输入口令。
+  //不支持*.xls *.doc文件；不支持的格式实际在浏览器拖拽窗口后会蜕变成了下载形式的。被加密的文件必须提前解密,网站登录需提前解决。
+  //【特殊问题】若URL网页动态化太离谱，周期性地不间断地更新页面,没法触发加载结束事件的，只能手动在浏览器查看打印另存pdf，然后把手动生成pdf合并进来。Tab切换会主动刷新的也不触发。
+  url: string;
+  //输出本地工作目录的文件名， 不需要加 .pdf结尾的 【注意】如果out为空表示url是pdf的没必要转换的要直接进入合并步骤。
+  //【特别】必须配置唯一性 的本地 工作目录的文件名，同名的被直接覆盖了。
+  out: string;
+
+  //是否汇总合并阶段省略本url，不合并进去，那就是单独独立的pdf输出了。默认=true是合并进去。 和是否打印页眉页脚或页眉统计页数没有绝对关系的。
+  merge?: boolean;
+
+  //默认取值都是=true; 第一阶段不会生成页眉页脚的，汇总第二阶段这个参数才会生效！
+  //这里配置displayHeaderFooter优先级最高。
+  //页眉页脚如何分开控制是否打印的： 可以把lay{head，foot}其中一个配置串给设置为null,null就代表不输出。例如head=null就不输出页眉，但是页脚照旧打印的。本url的配置优先于汇总pdf配置。
+  //若ConfigRoot<T>.merge=false那么必然导致FileTransform.merge强制=false，每个独立pdf页码独立的独立都从1开始编号吗还需要打印吗，页眉页脚需要打印吗？这个情况页眉页脚打印的默认值改成false;
+  displayHeaderFooter: boolean;
+
+  //【特别注意】frNo 可能和 headFrom 配置矛盾。
+  //本url打印：从第几页才开始页眉页脚的打印，#页码同样也是在这之后才可能计数和编号!。默认值headFrom=1：就是第一页就开始打印页眉页脚的。
+  //书本封面页情况的。这个参数有最高优先级。 【注意】和frNo设置相互影响, 没有页眉页脚就失去页码意义了。若真的违反了可能页码不能连续输出的，被隐藏了页码缘故。
+  headFrom?: number;
+  //本url打印后，从本URL输出的第几页开始才进行的页码序号的顺序输出的，前面几页不打印页码(但是页眉页脚要打印)。默认值=1全部都打页码。若frNo=0全部不打页码的。
+  //假如displayHeaderFooter=false也即页码无法显示出来的情况：请申明frNo=0; 不然默认是连续页码的，不打印的也有占用页码的隐藏的连续数字啊。
+  //注意若有配置 headFrom 的要协调好。
+  frNo?: number;
+
+  //是否对页码支持连续编号：  Continuous numbering 是跟随汇总合并的页码 基数合计。【注意】本配置单个url范围，单个url不能混合本地页码和全局页面两种！
+  //统计页数是否本URL独立自己范围之内进行的汇总计数。比如书本目录有多页的可以独立统计页码序号以及总页数的。默认=false;
+  localSumNo?: boolean;
+  //本url对应的部分应该用的页眉页脚，覆盖掉合并pdf的相对应设置。页面上只能支持输出一次页眉页脚，不重叠做输出。
+  //若lay{localSumNo=false}只能固定支持本url自己内部的页码统计顺序编号，不考虑合并pdf总页数带来的影响的。 还是？预设其它部分的页数统计总数之后？再做偏移页码编写？
+  lay: PartHeadFooter;
+  //前端声明本url在第一阶段打印输出后，生成的pdf应该有几页。 count没有设置的救不会做异常检查的。不是第二阶段的计数：双面情况可能增加空白页
+  count?: number;
+  //双面打印的 默认=true, 表示独立分开输出的pdf文件的：考虑到双面打印的页眉页脚的布局差异化情况了。
+  //合并输出merge=true的情况：该参数无效，要看汇总配置的哪一个 # ConfigRoot<T>{ doubleSide： }字段。
+  doubleSide: boolean;
+  //双面打印的情形：必须确保本URL的第一个页是正好右手边(书本翻页的奇数号页码)开始的位置页。正常第一个URL首页面就是双面打印的右手边位置页；默认值=false不必确保.
+  rightHand: boolean;
+
+  //页码是罗马数字；论文目录需要的；默认=false阿拉伯数字。"I","II","III","IV","V","VI","VII","VIII","IX" "X"XI"XII"表盘符号
+  //roman只能针对本URL启用；数字转换范围最大支持1到12，超过了便改阿拉伯数字，且只针对pageNumber有效, totalPages不会采用。
+  roman?: boolean;
+
+  //下面这5个参数不是前端配置发送过来的，而是lay{}对象预先进行转换后保存的汇总页眉页脚，只能内部使用，并非外部接口参数！Page.printToPDF需要的。
+  headerTemplate?: string;
+  footerTemplate?: string;
+  headerTemplateL?: string;
+  footerTemplateL?: string;
+  //这针对：可能由于动态布局导致的浏览器打印预览和实际URL纯粹js网页动态布局的真实内容页数不一致的毛病。
+  //开启的浏览器窗口宽度。默认最大化的。
+  brwidth?: number;
+  //第一阶段Url转pdf的浏览器执行窗口的targetId,不可配置。
+  CDPtab?: string;
+}

package/src/utils/pdfgen.ts

@@ -5,9 +5,10 @@ import CDP from "chrome-remote-interface";
 import _ from "lodash";
 // @ts-ignore
 import config from "config";
-import CONFIG from "@/configEnv";
-import { ConfigRoot, FileTransform, MyPaperSize } from "@/types/request/config";
-import { filePathToUrl } from "@/utils/url";
+import CONFIG from "../configEnv";
+import { MyPaperSize } from "../types/request/config";
+import { filePathToUrl } from "../utils/url";
+import { ConfigRoot, FileTransform } from "@/types";
 
 //自定义纸张系列的：
 const paperSZs = config.get("size") as MyPaperSize[];
@@ -78,6 +79,7 @@ interface IRenderPdfOptions {
   landscape?: boolean;
   includeBackground?: boolean;
   windowSize?: boolean;
+  //纸张  英寸为单位的。  限制打印输出的用
   paperWidth?: number;
   paperHeight?: number;
   pageRanges?: string;
@@ -92,6 +94,7 @@ interface IRenderPdfOptions {
   marginBottom?: number;
   marginLeft?: number;
   marginRight?: number;
+  //有些 要打印 背景图片的需要？
   printBackground?: boolean;
 }
 
@@ -124,6 +127,7 @@ export class RenderPDF {
    * 奇数页还是偶数页的，双面打印对页码位置可能会调整位置的，而单独一个URL生成pdf时刻有可能没法就一定能够正确打印页码文字的是定位位置啊。抛弃支持：纯静态html横竖方向混合的场景,独立转换抽取部分纸张到过渡的pdf或拆解组合来做。
    * 还是考虑：保留第一阶段页眉页脚的打印能力，但是仅仅针对：特殊url：file[url:{ 只能是独立的页码编码和页码合计数独自计数，不涉及到其它的URL的 }]，双面打印：页码只能放在中间位置为好，页码必须从第一页开始编码的，而且这种情况目标是不采用叠加页眉页脚两次pdf方案(一次性，不提取出CSS纸张方向)。
    * 最终采用引入reverseRanges参数设置部分纸张反转纸张方向，需要配置某某页并和CSS打印第一阶段生成的pdf能够吻合纸张方向的话，就能确保页眉页脚叠加正常位置。这里步骤就免于处理页眉页脚的生成了。
+   * CDP【Target】才是开启URL的。浏览器初始化； Page是打印输出的。
    * */
   async renderPdf(task: ConfigRoot<FileTransform>, tsobj: FileTransform) {
     let options = {} as IRenderPdfOptions;
@@ -139,6 +143,7 @@ export class RenderPDF {
     const { CDPclient, targetId } = await this.newTabOrPage(
       this.getCDPhostPort(),
       url,
+      tsobj.brwidth,
     );
     // await RenderPDF.newTabOrPage(this.getCDPhostPort(), url);
     // const client = await CDP({ host: this.host, port: this.port });
@@ -156,7 +161,7 @@ export class RenderPDF {
       url: url,
       //frameId: targetId, 不能加上： 本地pdf情形实际会有webview/iframe,实际会看到pdf之外的浏览控件框框的。
     });
-    if (errorText) throw new Error(errorText); //若是访问失败应该抛异常的！
+    if (errorText) throw new Error(errorText + " URL=" + url); //若是访问失败应该抛异常的！
     frameId;
     await Emulation.setVirtualTimePolicy({
       policy: "pauseIfNetworkFetchesPending",
@@ -343,7 +348,9 @@ export class RenderPDF {
     // renderer.killChrome();
   }
 
-  /**关键的： 某一个url的转换步骤 */
+  /**关键的： 某一个url的转换步骤
+   * @param tsobj 每一个独立URL生成 FileTransform 配置的
+   * */
   async generateSinglePdf(
     tsobj: FileTransform,
     task: ConfigRoot<FileTransform>,
@@ -512,7 +519,9 @@ export class RenderPDF {
     return ret;
   }
 
-  /**汇总步骤入口: 前提 :前面已经生成独立的多个pdf */
+  /**汇总步骤入口: 前提 :前面已经生成独立的多个pdf
+   * 另外 还有await renderer.newTabOrPage(/ renderer.yemeiyejiaoPageGen( 是用于生成页眉页脚的每一页都有独立临时pdf。
+   * */
   static async MergeAllPdfs(
     task: ConfigRoot<FileTransform>,
     options: IRenderPdfOptions,
@@ -737,12 +746,12 @@ export class RenderPDF {
       headerTemplate0 = headerTemplate0?.replace("-NOT_DISPLAY-", "");
       headerTemplate0 = headerTemplate0
         ?.replace(
-          "${pageNumber}",
+          "~pageNumber~",
           tsobj.roman && pageNumber > 0 && pageNumber < 13
             ? ROMA_NUMS[pageNumber]
             : "" + pageNumber,
         )
-        .replace("${totalPages}", "" + totalPages);
+        .replace("~totalPages~", "" + totalPages);
     }
     options.headerTemplate = headerTemplate0;
     let footerTemplate0;
@@ -769,12 +778,12 @@ export class RenderPDF {
       footerTemplate0 = footerTemplate0?.replace("-NOT_DISPLAY-", "");
       footerTemplate0 = footerTemplate0
         ?.replace(
-          "${pageNumber}",
+          "~pageNumber~",
           tsobj.roman && pageNumber > 0 && pageNumber < 13
             ? ROMA_NUMS[pageNumber]
             : "" + pageNumber,
         )
-        .replace("${totalPages}", "" + totalPages);
+        .replace("~totalPages~", "" + totalPages);
     }
     options.footerTemplate = footerTemplate0;
 
@@ -792,16 +801,17 @@ export class RenderPDF {
     return null;
   }
 
-  /**直接嵌入用户打开的浏览器的模式下，独立的开启新的浏览器窗口需要：
-   * 问题：刚用createTarget立刻获取targetId(frameId)没法正常工作，
-   * 这里await CDP(options)必须做两次!!：没法避免，否则干扰用户窗口，要么新Tab没有实际准备好的。
-   * */
-  async newTabOrPage(options: CDPbeginParam, url: string) {
+  async newTabPageInner(options: CDPbeginParam, url: string, brwidth?: number) {
     const client1 = await CDP(options); // await CDP({ host: options.host, port: options.port });
-    const { Target } = client1;
+    const { Target, Browser } = client1;
+    //页眉页脚也会开动新的Tab; 没尝试出来：用这个入口就可控制浏览器窗口的宽度的办法。
     await Target.createTarget({
       url: url,
       background: true,
+      width: 719, //无效：(headless chrome only)不算无头模式的，有展示交互式窗口啊。
+      newWindow: true,
+      // enableBeginFrameControl: true,
+      forTab: true,
     });
     //前端编码之escape、encodeURI对的, 和 encodeURIComponent
     const { targetInfos } = await Target.getTargets();
@@ -809,12 +819,49 @@ export class RenderPDF {
       //"type": "webview", iframe, background_page, ...
       return tab.type === "page" && tab.url === url;
     });
-    client1.close(); //原先每次关闭的：
+    //targetId就是目标窗口的实例。
     if (!target.targetId) throw new Error("没开启窗口:" + url);
+    if (brwidth) {
+      //需要约束浏览器 来避免打印页数不正常的，web页面的动态布局导致的，打印结果太少太多页数。
+      const { windowId, bounds } = await Browser.getWindowForTarget({
+        targetId: target.targetId,
+      });
+      const objectWidth = brwidth;
+      const newbounds = {
+        ...bounds,
+        width: objectWidth,
+        windowState: "normal",
+      };
+      await Browser.setWindowBounds({ windowId, bounds: newbounds });
+      const { bounds: realBound } = await Browser.getWindowBounds({ windowId });
+      const newRealWidth = realBound?.width;
+      if (objectWidth !== newRealWidth)
+        throw new Error("开窗口宽度不适当:" + newRealWidth);
+    }
+    client1.close(); //原先每次关闭的：
     const client = await CDP(options);
+
     //这些用例简易网页：frameId实际等同targetId；因没有嵌套<iframe />标签的。
     return { CDPclient: client, targetId: target.targetId };
   }
+  /**直接嵌入用户打开的浏览器的模式下，独立的开启新的浏览器窗口需要：
+   * 问题：刚用createTarget立刻获取targetId(frameId)没法正常工作，
+   * 这里await CDP(options)必须做两次!!：没法避免，否则干扰用户窗口，要么新Tab没有实际准备好的。
+   * 另外入口是：页眉页脚是使用纯粹 静态的 yemeiyejiaoHtml 来生成的每一页的独立页眉页脚pdf再合并的，不需要考虑浏览器宽度大小会影响到（不是动态布局的内容）。
+   * */
+  async newTabOrPage(options: CDPbeginParam, url: string, brwidth?: number) {
+    //多尝试一次， 浏览器宽度设置可能不能一次性成功的。
+    for (let i = 0; i < 2; i++) {
+      try {
+        const result = await this.newTabPageInner(options, url, brwidth);
+        return result;
+      } catch (e) {
+        // @ts-ignore
+        if (!e.message.startsWith("开窗口宽度不适当:")) console.error(e);
+      }
+    }
+    throw new Error("开启窗口尝试2次失败:" + url);
+  }
   /**假如不是当前刚刚操作的Tab的话？：
    * */
   async closeTabOrPage(client: any, target: string) {

package/src//346/265/213/350/257/225.txt

@@ -1,4 +1,4 @@
-工程目录：page2pdf-server/执行 npm publish 发布到npm
+工具包需要发布，工程目录：page2pdf-server/执行 npm publish 发布到npm
 后端没有单步调试模式太不好了，原本直接start就能单步调试，后来不行了，jest来解决：
 __test__/./generatePdf.test.ts问题：jest用Run模式正常，可是若Debug模式单步调试的，.post(`/api/pdf`).send就会提前中止！原因xxxController容不下多个接口函数？
 /?有断点运行卡着的并且xxxController类里有两个函数的？提前中止啊；非得拆分两个文件。
@@ -171,6 +171,8 @@ headerTemplate = `<div style="position: relative; width:100%; text-align:center;
       <div style="position: absolute; width:100%; text-align: center; bottom: 5px;"><span class=title></div>
         <div style="position: absolute; text-align: right; bottom: 5px;right: 20px;">version: 1.0</div>
       </div>`;
+
+默认标题 '<div style=\\"position: absolute; width:100%; text-align: center; bottom: 5px;\\"><span id=\\"titlespan\\" class=title></div>',
 使用chrome, 不能以root账号直接使用   https://www.cnblogs.com/kk1893/p/14985512.html
 let browserOptions = { args: ['--no-sandbox', '--disable-setuid-sandbox'] };
 物理打印机系统对话框设置：可能能配置装订线宽度和页码输出的{套中套}可分拆却就不能文件合并。
@@ -241,4 +243,26 @@ package.json:: start 又能使用单步调试模式运行了，奇怪，为何
 }
 BD1CE5AD1D724197A177AC4E50DDB4A6
 
-去掉bcrypt包 @mapbox/node-pre-gyp node-gyp 依賴python啊
+去掉bcrypt包 @mapbox/node-pre-gyp node-gyp 依賴python啊
+useMeasure(dynctRef0)?.height 所获得尺寸实际针对屏幕的，在打印机场景该取值还是来自屏幕的，并非纸张打印语义的尺寸；没法测量打印时刻的div高度？。
+
+新电脑，不是管理员账户跑的开发环境，POST http://localhost:9389/api/pdf 出现error: Error: connect ECONNREFUSED 127.0.0.1:9872
+只好另外管理员用户启动浏览器窗口。当前打印服务器的为何却要调用管理员账户启动的浏览器？不能直接用当前用户启动浏览器，非要windows管理员窗口的。
+奇怪浏览器手动去打印必须勾选页眉页脚才正常，没选的表格最右边会不见了，但是打印服务器不受此困扰，两者看似能确保页数一致性的。
+去掉了： 没法在生产版本中用，没包报错
+  "devDependencies": {
+      "@types/module-alias": "^2.0.1",
+      "module-alias": "^2.2.3",
+  }
+不是module-alias的问题，而是node_modules在生产目录底下也不能缺少啊！直接拷贝也行！  https://blog.csdn.net/qq_35624642/article/details/128960311
+windows用户若非管理员账户的：桌面上的Chrome快捷方式右键点属性在“兼容性”设置中：必须勾选“管理员身份运行”！否则端口remote-debugging-port没开启。
+【浏览器有BUG】
+预览打印的，若没有勾选页眉页脚的话可能导致表格输出的右边边框被裁剪看不见表格右边线了，就只能勾选页眉页脚，但是我这个打印转换服务器没有这个毛病。
+但问题是：勾不勾选页眉页脚会不会影响到了实际打印输出的页数啊？目前还未发现这个影响存在的。
+如何限制打印时刻浏览器宽的：
+入口代码：src/utils/pdfgen.ts 的 async renderPdf(task: ConfigRoot<FileTransform>, tsobj: FileTransform) 浏览器打印主入口：
+【CDP文档】  https://chromedevtools.github.io/devtools-protocol/tot/Target/
+首先必须手动开启chrome浏览器；而且这个浏览器窗体宽度直接影响打印输出！可能会漏打，动态div测量调整布局问题。影响到浏览器其它用途体验。
+yarn又失败： 无法访问上 https://registry.npmjs.org/
+问题：有些URL网页，一直在等待加载好，死等打印命令没结果，估计CDP依据页面的网络消息决定加载结束与否的。
+端口已经被占用，启动不能访问预定端口的：查进程 netstat -ano | findstr :9872        #找出 LISTENING  10972 =进程ID；杀掉

package/test//346/211/223/345/215/260/346/234/215/345/212/241.http

@@ -0,0 +1,17 @@
+POST http://localhost:9389/api/pdf
+Accept: application/json
+Content-Type: application/json; charset=utf-8
+
+{
+  "merge": true,
+  "name": "asjsak啊实打实2",
+  "lay": {
+  },
+  "files": [
+    {
+      "url": "http://192.168.1.102:3765/originalView/CR-JJ/ver/1/-3kfCWcBRx66P8YA7EOkXFJlcG9ydA/printAll",
+      "out": "横页脚的VS2"
+    }
+  ]
+}
+###

package/tsconfig.json

@@ -1,13 +1,16 @@
 {
   "compilerOptions": {
-    /* Basic Options */
-    "incremental": true,
-    "target": "ESNext",
-    "module": "commonjs",
-    "outDir": "dist",
+    "declaration": false,  // 关闭自动生成声明文件
+    "outDir": "./dist",
+    "rootDir": "./src",
     "pretty": true,
     "removeComments": true,
 
+//    "declarationDir": "./dist/types",  // 声明文件输出目录
+//    "emitDeclarationOnly": true, // 仅生成声明文件
+    "module": "ESNext",
+    "target": "ES2021",
+
     /* Strict Type-Checking Options */
     "strict": true,
     "noImplicitAny": true,
@@ -37,5 +40,5 @@
     },
   },
   "include": ["src/**/*", "**/__tests__/**/*"],
-  "exclude": ["node_modules"]
+  "exclude": ["node_modules", "dist"] // 排除的目录
 }

package/.husky/pre-commit

@@ -1,6 +0,0 @@
-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
-yarn prettify
-yarn lint:fix
-git add

package/.husky/pre-push

@@ -1,4 +0,0 @@
-#!/bin/sh
-. "$(dirname "$0")/_/husky.sh"
-
-yarn build

package/.idea/codeStyles/Project.xml

@@ -1,58 +0,0 @@
-<component name="ProjectCodeStyleConfiguration">
-  <code_scheme name="Project" version="173">
-    <HTMLCodeStyleSettings>
-      <option name="HTML_SPACE_INSIDE_EMPTY_TAG" value="true" />
-      <option name="HTML_ENFORCE_QUOTES" value="true" />
-    </HTMLCodeStyleSettings>
-    <JSCodeStyleSettings version="0">
-      <option name="FORCE_SEMICOLON_STYLE" value="true" />
-      <option name="SPACE_BEFORE_FUNCTION_LEFT_PARENTH" value="false" />
-      <option name="FORCE_QUOTE_STYlE" value="true" />
-      <option name="ENFORCE_TRAILING_COMMA" value="Remove" />
-      <option name="SPACES_WITHIN_OBJECT_LITERAL_BRACES" value="true" />
-      <option name="SPACES_WITHIN_IMPORTS" value="true" />
-    </JSCodeStyleSettings>
-    <TypeScriptCodeStyleSettings version="0">
-      <option name="FORCE_SEMICOLON_STYLE" value="true" />
-      <option name="SPACE_BEFORE_FUNCTION_LEFT_PARENTH" value="false" />
-      <option name="FORCE_QUOTE_STYlE" value="true" />
-      <option name="ENFORCE_TRAILING_COMMA" value="Remove" />
-      <option name="SPACES_WITHIN_OBJECT_LITERAL_BRACES" value="true" />
-      <option name="SPACES_WITHIN_IMPORTS" value="true" />
-    </TypeScriptCodeStyleSettings>
-    <VueCodeStyleSettings>
-      <option name="INTERPOLATION_NEW_LINE_AFTER_START_DELIMITER" value="false" />
-      <option name="INTERPOLATION_NEW_LINE_BEFORE_END_DELIMITER" value="false" />
-    </VueCodeStyleSettings>
-    <codeStyleSettings language="HTML">
-      <option name="SOFT_MARGINS" value="80" />
-      <indentOptions>
-        <option name="INDENT_SIZE" value="2" />
-        <option name="CONTINUATION_INDENT_SIZE" value="2" />
-        <option name="TAB_SIZE" value="2" />
-      </indentOptions>
-    </codeStyleSettings>
-    <codeStyleSettings language="JavaScript">
-      <option name="SOFT_MARGINS" value="80" />
-      <indentOptions>
-        <option name="INDENT_SIZE" value="2" />
-        <option name="CONTINUATION_INDENT_SIZE" value="2" />
-        <option name="TAB_SIZE" value="2" />
-      </indentOptions>
-    </codeStyleSettings>
-    <codeStyleSettings language="TypeScript">
-      <option name="SOFT_MARGINS" value="80" />
-      <indentOptions>
-        <option name="INDENT_SIZE" value="2" />
-        <option name="CONTINUATION_INDENT_SIZE" value="2" />
-        <option name="TAB_SIZE" value="2" />
-      </indentOptions>
-    </codeStyleSettings>
-    <codeStyleSettings language="Vue">
-      <option name="SOFT_MARGINS" value="80" />
-      <indentOptions>
-        <option name="CONTINUATION_INDENT_SIZE" value="2" />
-      </indentOptions>
-    </codeStyleSettings>
-  </code_scheme>
-</component>

package/.idea/codeStyles/codeStyleConfig.xml

@@ -1,5 +0,0 @@
-<component name="ProjectCodeStyleConfiguration">
-  <state>
-    <option name="USE_PER_PROJECT_SETTINGS" value="true" />
-  </state>
-</component>

package/.idea/encodings.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="Encoding">
-    <file url="file://$PROJECT_DIR$/eslintrc.json" charset="GBK" />
-    <file url="file://$PROJECT_DIR$/src/testCSS.html" charset="GBK" />
-  </component>
-</project>

package/.idea/inspectionProfiles/Project_Default.xml

@@ -1,7 +0,0 @@
-<component name="InspectionProjectProfileManager">
-  <profile version="1.0">
-    <option name="myName" value="Project Default" />
-    <inspection_tool class="Eslint" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="TsLint" enabled="true" level="WARNING" enabled_by_default="true" />
-  </profile>
-</component>

package/.idea/modules.xml

@@ -1,8 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <component name="ProjectModuleManager">
-    <modules>
-      <module fileurl="file://$PROJECT_DIR$/.idea/tenstack-starter-main.iml" filepath="$PROJECT_DIR$/.idea/tenstack-starter-main.iml" />
-    </modules>
-  </component>
-</project>

package/.idea/page2pdf-server.iml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="WEB_MODULE" version="4">
-  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$">
-      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
-      <excludeFolder url="file://$MODULE_DIR$/temp" />
-      <excludeFolder url="file://$MODULE_DIR$/tmp" />
-    </content>
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>

package/.idea/tenstack-starter-main.iml

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<module type="WEB_MODULE" version="4">
-  <component name="NewModuleRootManager">
-    <content url="file://$MODULE_DIR$">
-      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
-      <excludeFolder url="file://$MODULE_DIR$/temp" />
-      <excludeFolder url="file://$MODULE_DIR$/tmp" />
-    </content>
-    <orderEntry type="inheritedJdk" />
-    <orderEntry type="sourceFolder" forTests="false" />
-  </component>
-</module>