add javascript

docs/basic-usage/creating-pdfs.md

@@ -29,3 +29,28 @@ use Spatie\LaravelPdf\Facades\Pdf;
 
 Pdf::html('<h1>Hello world!!</h1>')->save('/some/directory/invoice.pdf');
 ```
+
+## Using Javascript
+
+The JavaScript in your HTML will be executed when the PDF is created. You could use this to have a JavaScript charting library render a chart.
+
+Here's a simple example. If you have this Blade view...
+
+```blade
+<div id="target"></div>
+
+<script>
+    document.getElementById('target').innerHTML = 'hello';
+</script>
+```
+
+... and render it with this code...
+
+```php
+use Spatie\LaravelPdf\Facades\Pdf;
+
+Pdf::view('your-view')->save($pathToPdf);
+```
+
+... the text `hello` will be visible in the PDF.
+

tests/PdfTest.php

@@ -136,3 +136,9 @@
     expect(getTempPath('second.pdf'))
         ->toHaveDimensions(612, 792);
 });
+
+it('will execute javascript', function() {
+   Pdf::view('javascript')->save($this->targetPath);
+
+   expect($this->targetPath)->toContainText('hello');
+});

workbench/resources/views/javascript.blade.php

@@ -0,0 +1,5 @@
+<div id="target"></div>
+
+<script>
+    document.getElementById('target').innerHTML = 'hello';
+</script>