如何在 node-pdfkit 中使用异步函数？

Question

我正在尝试使用PDFKit 创建一个 PDF 文件。我插入这样的图像：

var PDFDocument = require('pdfkit');
var doc = new PDFDocument();

doc.image(some_image_as_buffer);

它正在按预期工作。但是现在想要修剪图像，我找到了GraphicsMagick for node.js。但我遇到的问题是让它与 PDFKit 一起工作。 doc.image 需要一个文件名或一个缓冲区，但由于我已经有一个缓冲区，所以我想使用缓冲区（因为缓冲区直接来自数据库，所以任何地方都没有文件）。

修剪工作如下：

var gm = require('gm');
gm(some_image_as_buffer, 'image.png')
  .trim()
  .toBuffer(function(err, trimmed_image_buffer) {
    // trimmed_image_buffer is correct,
    // but I can't put it to the document like this:
    doc.image(trimmed_image_buffer);
    // beacause I don't know which page and/or position
    // the doc is currently on, because of the asynchronous
    // nature of this callback.
  });

更新：

澄清：我希望能够在 PDFKit 的同步代码中使用异步修剪图像。 PDFKit 只能同步工作，gm 不提供同步接口。

UPDATE2：

var gm = require('gm');
gm(some_image_as_buffer, 'image.png')
  .trim()
  .toBuffer(function(err, trimmed_image_buffer) {
    // trimmed_image_buffer is correct,
    // but I can't put it to the document like this:
    doc.image(trimmed_image_buffer);
    // beacause I don't know which page and/or position
    // the doc is currently on, because of the asynchronous
    // nature of this callback.
  });
doc.text('some text');
// is not guaranteed to run after image is inserted
// and a couple of hundred lines more

在此示例的最后一行之后，还有更多代码行向 PDF 添加内容，但我不想仅仅因为我需要异步函数而将所有内容（几百行）放在一个回调中操作图像。

有什么方法可以使这种操作同步吗？

Answer 1

UPDATE_2

您基本上要求停止执行代码，直到某些异步操作完成。 肯定一般情况下是不可能的。

如果是gm 模块，也不可能。 gm 模块生成一个新进程来执行命令（在您的情况下为 trim()），并且生成新进程的 API 本质上是异步的。

更新

在你的场景中使用 Promise：

var gm = require('gm'),
    Q = require('Q'),
    PDFDocument = require('pdfkit'),
    doc = new PDFDocument();

function getTrimmedImage(some_image_as_buffer){
  var deferred = Q.defer(); 
  gm(some_image_as_buffer, 'image.png')
  .trim()
  .toBuffer(function(err, trimmed_image_buffer) {
    if(err) { deferred.reject(err); }
    else { deferred.resolve(trimmed_image_buffer); }
  });
  return deferred.promise;
}

// here goes all manipulations before the trimmed image is inserted

getTrimmedImage(some_image_as_buffer).then(
  function(trimmed_image_buffer){
     doc.image(trimmed_image_buffer);

     // here goes all manipulations after the trimmed image is inserted

  }
);

---

正如我在上面的评论中所写，基于 Promise 的解决方案应该可以优雅地工作。我使用Q library，但任何其他承诺库也可以完成这项工作。

一种选择是在开始操作 pdf 之前收集所有异步资源。然后，您可以保证不会发生竞争条件，尽管它可能会减慢整个过程。我使用了一个玩具示例让它在浏览器环境中运行，如果您在将其转换为您的用例时遇到任何问题，请告诉我：

function getAsyncResource(){
  
  var defer = Q.defer();
  
  setTimeout(function(){
    var result = "Some value: " + Date.now();
    console.log("Async resource resolved: " + result); 
    defer.resolve(result);
    }, Math.random() * 5000);
  
  
  return defer.promise;
  }

function someOperationThatNeedsAsyncResources(A, B, C){
  
  console.log("Have all resources: ", A, B, C);
  
  }

var A = getAsyncResource(),
    B = getAsyncResource(),
    C = getAsyncResource();

Q.all([A,B,C]).spread(someOperationThatNeedsAsyncResources);

<script src="//cdnjs.cloudflare.com/ajax/libs/q.js/1.1.2/q.js"></script>

其他选择是将流程拆分为多个步骤，如下所示：

function getAsyncResource(value){
  
  var defer = Q.defer();
  
  setTimeout(function(){
    var result = "Some value: " + value;
    console.log("Async resource resolved: " + result); 
    defer.resolve(result);
    }, Math.random() * 5000);
  
  
  return defer.promise;
  }

function nextStep(resource){
   console.log("Next step: " + resource);
  }

var A = getAsyncResource("A"),
    B = getAsyncResource("B"),
    C = getAsyncResource("C");

A.then(nextStep)
 .then(function(){return B;})
 .then(nextStep)
 .then(function(){return C;})
 .then(nextStep);

<script src="//cdnjs.cloudflare.com/ajax/libs/q.js/1.1.2/q.js"></script>