Deprecate printToFile in favor of File IO. Per #730

Author: tresf

js/qz-tray.js

@@ -921,7 +921,7 @@ var qz = (function() {
          * Set the printer assigned to this config.
          * @param {string|Object} newPrinter Name of printer. Use object type to specify printing to file or host.
          *  @param {string} [newPrinter.name] Name of printer to send printing.
-         *  @param {string} [newPrinter.file] Name of file to send printing.
+         *  @param {string} [newPrinter.file] DEPRECATED: Name of file to send printing.
          *  @param {string} [newPrinter.host] IP address or host name to send printing.
          *  @param {string} [newPrinter.port] Port used by <printer.host>.
          */
@@ -930,6 +930,13 @@ var qz = (function() {
                 newPrinter = { name: newPrinter };
             }
 
+            if(newPrinter && newPrinter.file) {
+                // TODO: Warn for UNC paths too https://github.com/qzind/tray/issues/730
+                if(newPrinter.file.indexOf("\\\\") != 0) {
+                    _qz.log.warn("Printing to file is deprecated.  See https://github.com/qzind/tray/issues/730");
+                }
+            }
+
             this.printer = newPrinter;
         };
 

sample.html

@@ -1193,6 +1193,9 @@ <h4 class="panel-title">Options</h4>
                     <div class="form-group">
                         <label for="askFile">File:</label>
                         <input type="text" id="askFile" class="form-control" value="C:\tmp\example-file.txt" />
+                        <hr />
+                        <p><span class="text-danger" style="font-weight:bold;"><span class="fa fa-warning"></span> WARNING:</span> This feature has been deprecated.  Please configure a local raw <code>FILE:</code> printer, or use <code>File IO</code></a> instead.  For more
+                            information please see <a href="https://github.com/qzind/tray/issues/730">issue&nbsp;<code>#730</code>.</a></p>
                     </div>
                 </div>
                 <div class="modal-footer">