COPS项目在Kindle实验性浏览器中的模板切换问题分析与解决方案-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_07671/article/details/148466639

COPS项目在Kindle实验性浏览器中的模板切换问题分析与解决方案

seblucas-cops Calibre OPDS (and HTML) PHP Server : web-based light alternative to Calibre content server / Calibre2OPDS to serve ebooks (epub, mobi, pdf, ...) 项目地址: https://gitcode.com/gh_mirrors/se/seblucas-cops

问题背景

COPS（Calibre OPDS PHP Server）是一个基于PHP的电子书服务器，允许用户通过浏览器访问和管理Calibre书库。近期有用户反馈在Kindle设备的实验性浏览器中无法正常切换模板的问题。这个问题并非首次出现，之前也曾有过类似报告。

技术分析

Kindle实验性浏览器使用的是基于WebKit的旧版渲染引擎，其JavaScript引擎仅支持ECMAScript 3（ES3）标准，部分支持ES5特性。而现代Web开发中常用的ES6+特性（如let/const声明、includes方法等）在该浏览器中无法正常运行。

具体问题表现

模板切换功能失效：用户无法通过"Customize"页面更改界面模板和样式
Cookie设置失败：浏览器无法正确存储用户选择的模板偏好设置
页面刷新异常：切换模板后页面不能自动刷新应用新设置

根本原因

经过深入分析，发现问题主要源于以下几个方面：

JavaScript兼容性问题：新版COPS中使用了ES6+语法特性，如let/const声明、includes方法等
第三方库版本过高：js-cookie库3.x版本使用了较新的JavaScript特性
PHP会话配置问题：在Alpine Linux环境中，PHP默认未启用session支持

解决方案

1. JavaScript兼容性改进

针对Kindle浏览器的JavaScript限制，进行了以下改进：

将所有let/const声明替换为var
将includes()方法替换为indexOf()检查
简化DOM操作代码，避免使用现代API

2. Cookie处理优化

考虑到js-cookie 3.x版本在Kindle浏览器中的兼容性问题，提供了两种解决方案：

方案A：降级使用js-cookie 1.5.1版本

保持现有代码结构不变
确保向后兼容性
简单直接但可能影响其他功能

方案B：完全移除js-cookie依赖

实现原生Cookie操作函数
减少外部依赖
需要全面测试所有Cookie相关功能

最终选择了方案B，实现了以下原生Cookie函数：

function getCookie(name) {
    var cookies = document.cookie.split(';');
    for(var i = 0; i < cookies.length; i++) {
        var cookie = cookies[i].trim();
        if (cookie.indexOf(name + '=') === 0) {
            return decodeURIComponent(cookie.substring(name.length + 1));
        }
    }
    return null;
}

function setCookie(name, value, days) {
    var expires = "";
    if (days) {
        var date = new Date();
        date.setTime(date.getTime() + (days*24*60*60*1000));
        expires = "; expires=" + date.toUTCString();
    }
    document.cookie = name + "=" + encodeURIComponent(value) + expires + "; path=/";
}