现在,以编程方式在 Electron 中上传文件,是非常简单的!

必要的上下文

想尽快熟悉上下文语境的,可以点这里: https://github.com/electron/electron/issues/749

这段讨论,其实本来是讨论如何自动设置 input 标签的值来实现自动选择文件的.前一段有个 Electon 中自动上传文件的需求,被 Google 带到了这个讨论地址.虽然,最后当时是采用的不同讨论中的本地代理器转发cookie的策略,但不得不承认,这些讨论还是给了自己很大启发的 -- 虽然暂时并没有什么用.

It's near impossible to programmatically upload a file in electron right now.

当时,讨论区 @erikmellum 的一句 "现在在Electron 中,以编码方式上传文件,几乎是不可能的",让我放弃了对 Electron 本身机制的思考.转而,基于当时 App 已有的本地代理服务器, 做了另一番尝试.当然,最后也是成功了.这个机制,等会儿我会简单描述下.因为它已经不是重点了! 因为已经有了更简化的方式.

这个问题的关键是在于如何获取完整的 cookie,特别是 session 相关那一部分的 cookie.今天突然又看到 electron 文档的 session 部分,看到它有一个 cookies 属性.心想,这个 cookies, 既然是属于 electron 自有的 api,那岂不是也可以获取完整的 cookie ?试了下,还真是! 卒~

技术关键点分析

Electron,结合了 Node 和 Chromium.在相当程度上,可以认为它同时拥有了 Node 和 Chromium 的能力;另一方面,其实也可以认为,它拥有了 Node 和 Chromium 各自的限制.在 Electron 编码时,如何理解和运用 Node 和 Chromium 各自的限制和能力,就变得很有趣.如果能进一步地熟练打通 Node 和 Chromium ,真的可以做某些以前很难去想象的事.

具体到以编码方式上传文件这个问题上.这个问题的完整描述应该是类似于这样: 网站有自己的登录认证机制,在不需要在对网站登录机制做任何修改的前提下,如何自动上传用户相关的文件,比如用户头像?

我们就以自动上传用户头像为例.我们可以假定已经通过某种方式,得到了用户头像的本地路径.--这个大前提,在基于 Electron 的App中,非常容易满足!

对于 Chromium 侧的童鞋来说,拿到文件的本地路径后,是没有比较简便的办法实现文件上传的. https://github.com/electron/electron/issues/749#issuecomment-145764807 讨论中,提到的两个地址,再结合 https://developer.mozilla.org/en-US/docs/Web/API/FormData/Using_FormData_Objects 或许应该也是可以的.我没验证!

对于 Node 层的同学来说,有了文件路径,可以很容易地通过 https://www.npmjs.com/package/request 库来实现文件的上传,如果他能拿到当前回话的完整 Cookie 的话.当然,这个限制,也是有足够多的方式来弥补的,比如让用户在桌面 App 上,再单独登录一次.不管怎样,解决问题就好.

但是,Electron 提供了一种全新的可能.它让你可以在 Node 侧,直接拿到 Chromium 侧的完整 Cookie.然后你就可以使用 Node 的方式,以最精简的代码,最符合直觉的方式来处理文件上传.

好吧,借题插一句:我曾经处理过一个 XML 文件解析的需求.当时搜了各种 Node 库,都没太好使的,后来我是直接在 render process 中,直接用 html 的dom 接口去读取和解析的 xml 文件! -- 当时,被自己的机智惊呆了! 讲真, 使用 Electron 来开发桌面 App,你真正需要考虑的不是如何实现某个需求,而是如何以一种更优雅的方式来实现需求! 没有做不到,只有不敢想啊!!!

一个简单的实例: 实现开源中国用户头像自动更换

为了完整演示这一技术可能涉及的特定问题及其解决方案,我们就从真实环境中来构造一个需求: 实现开源中国用户头像自动更换. 当然,是不需要 OSC 的研发改任何代码的前提下!!!

安装 electron

安装,建议使用稳定版本 1.3.x 系列的,可能需要 科学上网,才能安装.基础的快速入门教程,参考: https://electron.atom.io/docs/tutorial/quick-start/

npm i electron@1.3.15 -g

jquery 无效问题.

我们把入门示例中的url换为 osc 官方的域名:

win.loadURL("https://www.oschina.net/")

cd 到项目目录,执行:

electron .

此时 electron 就运行起来了,不过当你切换到登录页后, devtool 窗口,应该会报错:

Uncaught ReferenceError: $ is not defined

错误的原因,可以参考: https://github.com/electron/electron/issues/254 不过解决方式,都不适用于这里的场景.因为我不能直接修改 OSC 网站源码.

不过 Electron 创建窗口时,提供了一个 preload 参数,允许注入一个 js 文件到网页上下中:

  win = new BrowserWindow({width: 1300, height: 720, webPreferences:{
    preload:path.resolve("./osc-preload.js")
  }})

然后,我们可以重写在注入的js中,重写 window 的 $ 和 jquery 属性的 getter 方法:

Object.defineProperties(window,{
    "$":{
            get: function () {
                return require("jquery")
            },
            configurable : true
        },
      "jQuery":{
              get: function () {
                  return require("jquery");
              },
              configurable : true
          }
    });

此处,之所以是重写getter,而不是直接赋值,是因为 jquery 依赖于特定的 dom 结构,但是预注入的js文件在执行时,是没有任何 dom 结构的.注入的js文件,执行时机非常早,甚至早过 dom 或任意其他css/js 文件 的加载或渲染.

有关重写 getter 和 setter 方法的技术细节,大家可以参考这里: https://segmentfault.com/a/1190000003882976

当然,此处需要我们先在本地项目中,先安装 jquery 依赖,从 osc 源码中分析出,它用的 2.2.4 版本,我们最好也安装对应版本:

npm i jquery@2.2.4 --save

找到头像上传接口

这个很容易,只要通过 ctrl/cmd + alt + i 快捷键打开devtool,然后自己替换下头像,找到那个 ajax 请求就可以了.

我们注意到 formData 主要有 img 和 user_code 两部分构成.

构造 img 字段

其实就是一个图片的 base 编码, Node 搞这个,轻轻松啊. 先安装一个工具库: base64-img

npm install base64-img --save

然后:

/* 我们有足够丰富的方式来获取或计算图片的路径,此处默认采用的方式就是:
当前目录下的 test.jpeg 图片.
另外,此处文件注意使用 jpeg 后缀.这要是 OSC 本身的限制.*/
const imgPath = path.resolve(__dirname,"./test.jpeg")

/* 此处,将文件转换为 base64,只是因为 osc 的头像变更接口,设计如此!! */
const imgData = base64Img.base64Sync(imgPath)

分析并获取 user_code

你要相信,任何在 Electron 打开的网站,即时你不是网站的拥有者,也可以获取比网站的前端研发人员更多的信息. Electron 的机制使然.

只要在 devtool 的源码区域,简单搜索下,就很容易发现 user_code 的来源.压缩后的源码,如果看着不输入,可以点击源码视图区左下角的格式化按钮 {} 格式化一下.

所以获取 user_code 的代码,就是:

    g = $("val[data-name=user_code]").data("value"),

获取完整 Cookie

Electron 有想成的 API 可以用.Cookie 操作的文档,参见:https://electron.atom.io/docs/api/cookies/

const { session } = require('electron').remote

session.defaultSession.cookies.get({
        url: window.location.href
    }, (error, cookies) => {
      console.log(cookies)
    })

使用 request 库发送头像更新请求

request 的详细文档,参考: https://www.npmjs.com/package/request.需要先安装依赖:

npm i request --save
const request = require("request")

request({
    url: `https://my.oschina.net/action/user/save_portrait_new`,
    method: "POST",
    formData: {
        img: imgData,
        user_code: userCode
    },
    headers: {
        "cookie": cookieStr
    }
}, function(err, response, body) {
  console.log(err, response, body)

  const {error} = JSON.parse(body)
  if ( ! error) {
    window.location.reload()
  }
})

实例完整源码

感兴趣的童鞋,记得 Star 关注下 !!!

https://github.com/ios122/demo-electron-share-cookie

关于使用本地代理服务器获取完整 cookie 的思路

这个思考,主要是基于当期 App 的现状 -- 已经有了一个用于加速静态资源访问速度的用作缓存功能的本地代理服务器,还有就是当时也对 Electron 的 session 和 cookie 的接口,不太熟悉, 而采用的临时措施.但毕竟可用,顺便说下.其中的本地代理服务器部分,还是有一定参考价值的.

关于本地代理服务器,大家可以看下 微信小程序开发工具,会看到它的网络请求的 remote address 都是本地地址,很明显它加了本地代理服务器.

本地代理服务器本身,可以使用 https://www.npmjs.com/package/http-proxy 这个库.

Electron 想要支持设置网络代理,主要是用到 https://electron.atom.io/docs/api/session/#sessetproxyconfig-callback 接口.唯一主要注意的是,这个接口必须在 main process 调用,才会生效.

使用本地代理服务器获取完整 cookie 的思路是: 约定某个url路径,比如 /-fetch-all-cookies 为获取 cookie 的路径 --> 前端发送 ajax 请求到 /-fetch-all-cookies --> 本地代理服务器,拦截到请求,如果发现路径是 /-fetch-all-cookies,就把当次请求的 header 中的cookie 部分,作为返回值返回 --> 前端获取到完整 cookie --> 前端调用 request 库,上传文件.

虽然不是最优最简方案,但或许可以算得上是 脑洞开的最大的方案!!! O(∩_∩)O哈哈哈~

参考链接:

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏北京马哥教育

让“懒惰” Linux 运维工程师事半功倍的 10 个关键技巧!

好的Linux运维工程师区分在效率上。如果一位高效的Linux运维工程师能在 10 分钟内完成一件他人需要 2 个小时才能完成的任务,那么他应该受到奖励(得到更...

3696
来自专栏phodal

你不再需要动态网页——编辑-发布-开发分离

尽管没有特别的动力去构建一个全新的CMS,但是我还是愿意去撰文一篇来书写如何去做这样的事——编辑-发布-开发分离模式是如何工作的。微服务是我们对于复杂应用的一种...

2119
来自专栏MongoDB中文社区

​MongoDB 4.0 系列之 \b—— 事务实现解析(\b一)

Mongodb4.0引入了多文档事务的特性,我们来看,4.0中是如何进行一个多文档事务的(js的mongoshell代码)。

1483
来自专栏企鹅号快讯

入门干货之用DVG打造你的项目主页-Docfx、Vs、Github

由于这三项技术涉及到的要点以及内容较多,希望大家有空能自己挖掘一下更多更深的用法。 0x01、介绍 VS,即VS2017以及以上版本,宇宙最好的IDE,集成了宇...

2006
来自专栏程序员的知识天地

众多Python Web框架比较,哪个适合你,你就用哪个!

Python程序员有很多很好的选择来创建Web应用程序和API;Django,Weppy,Bottle和Flask引领潮流。

1412
来自专栏炉边夜话

对中断的一点思考

    对于X86的单处理器机器,一般采用可编程中断控制器8259A做为中断控制电路。传统的PIC(Programmable Interrupt Contr...

1172
来自专栏SDNLAB

ONOS 实战分享(一):项目建立、调试到热部署

以上是ONOS的架构图,相信大家已经熟记于心了 本文将在Distributed Core Tier,以开发一个控制器内的模块为例,带领大家从项目的建立,导入I...

4177
来自专栏杨建荣的学习笔记

Oracle闪回原理-Logminer解读redo(r11笔记第17天)

说到闪回日志,我们都知道闪回日志中记录的都是逆操作,那么就有两个问题需要解释了。 闪回日志和回滚段保存的数据有什么差别? 如果做了truncate操作,闪回日志...

35612
来自专栏数据和云

数据库高可用和分区解决方案-MongoDB 篇

许春植(Luocs) (阿里巴巴高级数据库管理员,7年以上数据库运维管理经验,擅长MySQL、Oracle及MongoDB数据库,目前主要研究并建设Mongo...

6396
来自专栏happyJared

Linux私房菜:磁盘文件系统管理及常见命令

853

扫码关注云+社区