├── .github └── workflows │ └── ci.yml ├── .gitignore ├── LICENSE ├── NodeWScript.js ├── README.md ├── activex.js ├── binding.gyp ├── data └── test.xltm ├── examples ├── ado.js ├── event.js └── wbem.js ├── include └── node_activex.h ├── index.d.ts ├── index.js ├── lib_binding.gyp ├── package-lock.json ├── package.json ├── src ├── disp.cpp ├── disp.h ├── main.cpp ├── stdafx.h ├── utils.cpp └── utils.h └── test ├── ado.js ├── excel.js ├── variant.js ├── wscript.js └── wscript ├── README.md ├── arguments.js ├── enumerator.js ├── mixed.js ├── nodewscript_test_cli.cmd └── wmi.js /.github/workflows/ci.yml: -------------------------------------------------------------------------------- 1 | # https://docs.github.com/en/actions/use-cases-and-examples/building-and-testing/building-and-testing-nodejs 2 | 3 | name: ci 4 | on: [push, pull_request] 5 | jobs: 6 | ci: 7 | strategy: 8 | fail-fast: false 9 | matrix: 10 | node-version: ['18.x', '20.x', '22.x', '23.x'] 11 | os: [windows-latest] 12 | runs-on: ${{ matrix.os }} 13 | steps: 14 | - uses: actions/checkout@v4 15 | - uses: actions/setup-node@v4 16 | with: 17 | node-version: ${{ matrix.node-version }} 18 | - run: npm ci 19 | - run: npm run build --if-present 20 | # https://community.chocolatey.org/packages?q=Excel 21 | - name: "Installing Office 365 takes about 5 minutes..." 22 | run: choco install office365proplus 23 | - run: | 24 | npm install -g mocha 25 | # mocha --expose-gc test # Three tests will fail! 26 | - run: npm test 27 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | .vscode 2 | .idea 3 | node_modules 4 | build 5 | npm-debug.log 6 | test.js 7 | /data/PERSONS.DBF 8 | /debug* -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2023 Yuri Dursin 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /NodeWScript.js: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env node 2 | var g_winax = require('./activex'); 3 | var path = require('path'); 4 | 5 | if(process.argv.length<3) 6 | { 7 | console.error("Missing argument. Usage:\nnodewscript SomeJS.js ") 8 | } 9 | 10 | // For the case we want to use 'require' or 'module' - we need to make it available through global. 11 | global.require = require; 12 | global.exports = exports; 13 | global.module = module; 14 | 15 | global.SeSIncludeFile = function (includePath, isLocal, ctx) { 16 | 17 | var vm = require("vm"); 18 | 19 | var fs = require("fs"); 20 | var path = require("path"); 21 | 22 | var absolutePath = path.resolve(includePath); 23 | var data = fs.readFileSync(absolutePath); 24 | var script = new vm.Script(data, { filename: absolutePath, displayErrors: true }); 25 | if (isLocal && ctx) { 26 | if (!ctx.__runctx__) ctx.__runctx__ = vm.createContext(ctx); 27 | script.runInContext(ctx.__runctx__); 28 | } else { 29 | script.runInThisContext(); 30 | } 31 | 32 | return ''; 33 | }; 34 | 35 | global.GetObject = function GetObject(strMoniker) { 36 | return new g_winax.Object(strMoniker, {getobject:true}); 37 | } 38 | 39 | var WinAXActiveXObject = ActiveXObject; 40 | 41 | function ActiveXObjectCreate(progId, pfx) 42 | { 43 | var res = new WinAXActiveXObject(progId); 44 | if(progId=="SeSHelper") 45 | { 46 | // SeSHelper implements Include that we want to override 47 | res = new Proxy({helper:res}, { 48 | get(target, propKey, receiver) { 49 | return function (...args) { 50 | var helper = target.helper; 51 | var ovr = 52 | { 53 | IncludeLocal(/**Object*/fName, ctx) /**Object*/ 54 | { 55 | return this.Include(fName, true, ctx); 56 | }, 57 | 58 | Include(/**Object*/fName, local, ctx) /**Object*/ 59 | { 60 | var includePath = helper.ResolvePath(fName); 61 | if(!includePath) 62 | { 63 | var err = "Error trying to include file. File not found:"+fName; 64 | return "console.error("+JSON.stringify(err)+")"; 65 | } 66 | 67 | if(!local) 68 | { 69 | helper.SetAlreadyIncluded(includePath); 70 | } 71 | 72 | return global.SeSIncludeFile(includePath, local, ctx); 73 | 74 | }, 75 | 76 | IncludeOnce(/**Object*/fName) /**Object*/ 77 | { 78 | if(!helper.IsAlreadyIncluded(fName)) 79 | { 80 | return this.Include(fName); 81 | } 82 | return ""; 83 | } 84 | } 85 | 86 | if(propKey in ovr) 87 | { 88 | return ovr[propKey](...args); 89 | } else { 90 | let result = target.helper[propKey](...args); 91 | return result; 92 | } 93 | 94 | }; 95 | } 96 | }); 97 | } 98 | 99 | if(res&&pfx) 100 | { 101 | WScript.ConnectObject(res, pfx); 102 | } 103 | 104 | return res; 105 | } 106 | 107 | global.ActiveXObject=new Proxy(ActiveXObject, { 108 | construct(target,args) 109 | { 110 | //console.log("Creating ActiveXObject: "+args); 111 | return ActiveXObjectCreate(...args); 112 | } 113 | }); 114 | 115 | global.Enumerator = function (arr) { 116 | this.arr = arr; 117 | this.enum = arr._NewEnum; 118 | this.nextItem = null; 119 | this.atEnd = function () { return this.nextItem===undefined; } 120 | this.moveNext = function () { this.nextItem = this.enum.Next(1); return this.atEnd(); } 121 | this.moveFirst = function () { this.enum.Reset(); this.nextItem=null; return this.moveNext(); } 122 | this.item = function () { return this.nextItem; } 123 | 124 | this.moveNext(); 125 | } 126 | 127 | // See interface here 128 | // https://www.devguru.com/content/technologies/wsh/objects-wscript.html 129 | 130 | var WScript = { 131 | // Properties 132 | Application : null, 133 | BuildVersion : "6.0", 134 | FullName : null, 135 | Interactive : true, 136 | Name : "Windows / Node Script Host", 137 | Path : __filename, 138 | ScriptFullName : null, 139 | ScriptName : null, 140 | StdErr: { 141 | Write(txt) { console.log(txt); } 142 | }, 143 | StdIn: { 144 | ReadLine() { 145 | var readline = require('readline'); 146 | var gotLine = false; 147 | var line = undefined; 148 | 149 | var rl = readline.createInterface({ 150 | input: process.stdin, 151 | output: process.stdout, 152 | terminal: false 153 | }); 154 | 155 | rl.on('line', function (cmd) { 156 | line = cmd; 157 | rl.close(); 158 | }); 159 | while(!gotLine) 160 | { 161 | WScript.Sleep(10); 162 | } 163 | return line 164 | } 165 | }, 166 | StdOut: { 167 | Write(txt) { console.err(txt); } 168 | }, 169 | Timeout : -1, 170 | Version : 'NODE.WIN32', 171 | 172 | // Methods 173 | 174 | Echo : console.log, 175 | 176 | __Connected : [], 177 | 178 | ConnectObject(obj, pfx) 179 | { 180 | var connectionPoints = g_winax.getConnectionPoints(obj); 181 | var connectionPoint = connectionPoints[0]; 182 | var allMethods = connectionPoint.getMethods(); 183 | 184 | var advobj={}; 185 | var found = false; 186 | for(var i=0;i0) 232 | { 233 | WScript.DisconnectObject(this.__Connected[0].obj); 234 | } 235 | WScript.Sleep(60); 236 | process.exit(exitCode); 237 | }, 238 | 239 | Sleep (ms) { 240 | var begin = (new Date()).valueOf(); 241 | MessageLoop(); 242 | var dt = (new Date()).valueOf()-begin; 243 | 244 | while(dt{WScript.Quit(0);},timeOut*1000) 300 | } else if(arg.toLowerCase()=="//x"||arg.toLowerCase()=="//d") { 301 | this.__Debug = true; 302 | } 303 | } else { 304 | this.__Args.push(arg); 305 | } 306 | } 307 | } 308 | 309 | // The trick starts here 310 | // We want WScript.Arguments to be accessible in all of the following ways: 311 | // WScript.Arguments(i) 312 | // WScript.Arguments.item(i) 313 | // WScript.Arguments.length 314 | // Since it is not directly possible, we use a number of tricks. 315 | // Function.length is a number of expected arguments 316 | // And we make this 'fake' number 317 | var argArr=[]; 318 | for(var ai=0;ai") 351 | } 352 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Name 2 | 3 | Windows C++ Node.JS addon, that implements COM IDispatch object wrapper, analog ActiveXObject on cscript.exe 4 | 5 | # Features 6 | 7 | * Using *ITypeInfo* for conflict resolution between property and method 8 | (for example !rs.EOF not working without type information, becose need define EOF as an object) 9 | 10 | * Using optional parameters on constructor call 11 | ``` js 12 | var con = new ActiveXObject("Object.Name", { 13 | activate: false, // Allow activate existance object instance (through CoGetObject), false by default 14 | getobject: false, // Allow using name of the file in the ROT (through GetAccessibleObject), false by default 15 | type: true // Allow using type information, true by default 16 | }); 17 | ``` 18 | 19 | * Create COM object from JS object and may be send as argument (for example send to Excel procedure) 20 | ``` js 21 | var com_obj = new ActiveXObject({ 22 | text: test_value, 23 | obj: { params: test_value }, 24 | arr: [ test_value, test_value, test_value ], 25 | func: function(v) { return v*2; } 26 | }); 27 | ``` 28 | 29 | * Additional COM variant types support: 30 | - **int** - VT_INT 31 | - **uint** - VT_UINT 32 | - **int8**, **char** - VT_I1 33 | - **uint8**, **uchar**, **byte** - VT_UI1 34 | - **int16**, **short** - VT_I2 35 | - **uint16**, **ushort** - VT_UI2 36 | - **int32** - VT_I4 37 | - **uint32** - VT_UI4 38 | - **int64**, **long** - VT_I8 39 | - **uint64**, **ulong** - VT_UI8 40 | - **currency** - VT_CY 41 | - **float** - VT_R4 42 | - **double** - VT_R8 43 | - **string** - VT_BSTR 44 | - **date** - VT_DATE 45 | - **decimal** - VT_DECIMAL 46 | - **variant** - VT_VARIANT 47 | - **null** - VT_NULL 48 | - **empty** - VT_EMPTY 49 | - **byref** - VT_BYREF or use prefix **'p'** to indicate reference to the current type 50 | 51 | ``` js 52 | var winax = require('winax'); 53 | var Variant = winax.Variant; 54 | 55 | // create variant instance 56 | var v_short = new Variant(17, 'short'); 57 | var v_short_byref = new Variant(17, 'pshort'); 58 | var v_int_byref = new Variant(17, 'byref'); 59 | var v_byref = new Variant(v_short, 'byref'); 60 | 61 | // create variant arrays 62 | var v_array_of_variant = new Variant([1,'2',3]); 63 | var v_array_of_short = new Variant([1,'2',3], 'short'); 64 | var v_array_of_string = new Variant([1,'2',3], 'string'); 65 | 66 | // change variant content 67 | var v_test = new Variant(); 68 | v_test.assign(17); 69 | v_test.cast('string'); 70 | v_test.clear(); 71 | 72 | // also may be used cast function 73 | var v_short_from_cast = winax.cast(17, 'short'); 74 | ``` 75 | 76 | * Additional dignostic propeties: 77 | - **__id** - dispatch identity, for exmplae: ADODB.Connection.@Execute.Fields 78 | - **__value** - value of dispatch object, equiles valueOf() 79 | - **__type** - array all member items with their properties 80 | - **__methods** - list member mathods by names (ITypeInfo::GetFuncDesc) 81 | - **__vars** - list member variables by names (ITypeInfo::GetVarDesc) 82 | 83 | * Full WScript Emulation Support through nodewscript 84 | - **ActiveXObject** type 85 | - **WScript.CreateObject** 86 | - **WScript.ConnectObject** 87 | - **WScript.DisconnectObject** 88 | - **WScript.Sleep** 89 | - **WScript.Arguments** 90 | - **WScript.Version** 91 | - **GetObject** 92 | - **Enumerator** 93 | 94 | # Usage example 95 | 96 | Install package throw NPM (see below **Building** for details) 97 | ``` 98 | npm install winax 99 | npm install winax --msvs_version=2015 100 | npm install winax --msvs_version=2017 101 | ``` 102 | 103 | Create ADO Connection throw global function 104 | ``` js 105 | require('winax'); 106 | var con = new ActiveXObject('ADODB.Connection'); 107 | ``` 108 | Or using Object prototype 109 | ``` js 110 | var winax = require('winax'); 111 | var con = new winax.Object('ADODB.Connection'); 112 | ``` 113 | Open connection and create simple table 114 | ``` js 115 | con.Open('Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\tmp;Extended Properties="DBASE IV;"', '', ''); 116 | con.Execute("Create Table persons.dbf (Name char(50), City char(50), Phone char(20), Zip decimal(5))"); 117 | con.Execute("Insert into persons.dbf Values('John', 'London','123-45-67','14589')"); 118 | con.Execute("Insert into persons.dbf Values('Andrew', 'Paris','333-44-55','38215')"); 119 | con.Execute("Insert into persons.dbf Values('Romeo', 'Rom','222-33-44','54323')"); 120 | ``` 121 | Select query and return RecordSet object 122 | ``` js 123 | var rs = con.Execute("Select * from persons.dbf"); 124 | var reccnt = rs.RecordCount; 125 | ``` 126 | Inspect RecordSet fields 127 | ``` js 128 | var fields = rs.Fields; 129 | var fldcnt = fields.Count; 130 | ``` 131 | Process records 132 | ``` js 133 | rs.MoveFirst(); 134 | while (!rs.EOF) { 135 | var name = fields("Name").value; 136 | var town = fields("City").value; 137 | var phone = fields("Phone").value; 138 | var zip = fields("Zip").value; 139 | console.log("> Person: " + name + " from " + town + " phone: " + phone + " zip: " + zip); 140 | rs.MoveNext(); 141 | } 142 | ``` 143 | Or using fields by index 144 | ``` js 145 | rs.MoveFirst(); 146 | while (rs.EOF != false) { 147 | var name = fields[0].value; 148 | var town = fields[1].value; 149 | var phone = fields[2].value; 150 | var zip = fields[3].value; 151 | console.log("> Person: " + name + " from " + town + " phone: " + phone + " zip: " + zip); 152 | rs.MoveNext(); 153 | } 154 | ``` 155 | Release COM objects (but other temporary objects may be keep references too) 156 | ``` js 157 | winax.release(con, rs, fields) 158 | ``` 159 | Working with Excel ranges using two dimension arrays (from 1.18.0 version) 160 | * The second dimension is only deduced from the first array. 161 | * If data is missing at the time of SafeArrayPutElement, VT_EMPTY is used. 162 | * Best way to explicitly pass VT_EMPTY is to use null 163 | * If the SAFEARRAY dims are smaller than those of the range, the missing cells are emptied. 164 | * Exception to 4! Excel may process the SAFEARRAY as it does when processing a copy/paste operation 165 | ``` js 166 | var excel = new winax.Object("Excel.Application", { activate: true }); 167 | var wbk = excel.Workbooks.Add(template_filename); 168 | var wsh = wbk.Worksheets.Item(1); 169 | wsh.Range("C3:E4").Value = [ ["C3", "D3", "E3" ], ["C4", "D4", "E4" ] ]; 170 | wsh.Range("C3:E4").Value = [ ["C3", "D3", "E3" ], "C4" ]; // will let D4 and E4 empty 171 | wsh.Range("C3:E4").Value = [ [null, "D3", "E3" ], "C4" ]; // will let C3, D4 and E4 empty 172 | wsh.Range("C3:F4").Value = [ [100], [200] ]; // will duplicate the two rows in colums C, D, E, and F 173 | wsh.Range("C3:F4").Value = [ [100, 200, 300, 400] ]; // will duplicate the for cols in rows 3 and 4 174 | wsh.Range("C3:F4").Value = [ [100, 200] ]; // Will correctly duplicate the first two cols, but col E and F with contains "#N/A" 175 | const data = wsh.Range("C3:E4").Value.valueOf(); 176 | console.log("Cell E4 value is", data[1][2]); 177 | ``` 178 | 179 | ## TypeScript 180 | Your `tsconfig.json` needs at least the following configuration: 181 | 182 | 1. [`moduleResolution`](https://www.typescriptlang.org/tsconfig/#moduleResolution) needs to be something other than `classic`. Depending on your `target` and `module` this might be the default. For example: 183 | ```json 184 | { 185 | "compilerOptions": { 186 | "target": "esnext", 187 | "module": "nodenext" 188 | } 189 | } 190 | ``` 191 | 192 | 2. [`lib`](https://www.typescriptlang.org/tsconfig/#lib) needs to _**exclude**_ `ScriptHost`. It contains a conflicting global `ActiveXObject` type and is included by default. For example: 193 | ```json 194 | { 195 | "compilerOptions": { 196 | "lib": [ "ESNext" ] 197 | } 198 | } 199 | ``` 200 | 201 | # Tutorial and Examples 202 | 203 | - [examples/ado.js](https://github.com/durs/node-activex/blob/master/examples/ado.js) 204 | 205 | # Usage as a library 206 | 207 | The repo allows to re-use some of its code as a library for your own native node addon. 208 | 209 | To include it, install it as a normal node-dependency and then add it 210 | to the `"dependencies"` section of your `binding.gyp` file like this: 211 | ``` 212 | "dependencies": [ 213 | " 220 | ``` 221 | 222 | This makes functions like `Variant2Value` or `Value2Variant` that translate between COM VARIANT and node types 223 | available in your code. 224 | Note that providing this library functionality is not the core target of this repo however, 225 | so importing it eg. currently declares 226 | all methods in the global namespace and opens the namespaces `v8` and `node`. 227 | 228 | Check the source code [`src/disp.h`](src/disp.h) and [`src/utils.h`](src/utils.h) for details. 229 | 230 | # Building 231 | 232 | This project uses Visual C++ 2013 (or later versions then support C++11 standard). 233 | Bulding also requires node-gyp and python 2.6 (or later) to be installed. 234 | Supported NodeJS Versions (x86 or x64): 10, 11, 12, 13, 14, 15 235 | You can do this with npm: 236 | ``` 237 | npm install --global --production windows-build-tools 238 | ``` 239 | To obtain and build use console commands: 240 | ``` 241 | git clone git://github.com/durs/node-axtivex.git 242 | cd node-activex 243 | npm install 244 | ``` 245 | or debug version 246 | ``` 247 | npm install --debug 248 | ``` 249 | or using node-gyp directly 250 | ``` 251 | node-gyp configure 252 | node-gyp build 253 | ``` 254 | 255 | For Electron users, need rebuild with a different V8 version: 256 | ``` 257 | npm rebuild winax --runtime=electron --target=12.22.0 --dist-url=https://electronjs.org/headers --build-from-source 258 | ``` 259 | Change --target value to your electron version. 260 | See also Electron Documentation: [Using Native Node Modules](https://electron.atom.io/docs/tutorial/using-native-node-modules/). 261 | 262 | # WScript 263 | 264 | [WScript](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/wscript) is designed as a runtime, so WSH scripts should be executed from command line. WScript emulation mode allows one to use standard **WScript** features and mix them with nodejs and ES6 parts. 265 | 266 | There is one significant difference between WScript and NodeJS in general. NodeJS is designed to be [non-blocking](https://nodejs.org/en/docs/guides/blocking-vs-non-blocking/) and execution is done when last statement is done AND all pending promises and callbacks are resolved. WScript runtime is linear. It is done when last statement is executed. 267 | 268 | So NodeJS is more convenient for writing things like async web services. Also with NodeJS you get access to invaluable collection of **npm** modules. 269 | 270 | WScript has impressive collection of Windows-specific APIs available through ActiveX (such as `WScript.Shell`, `FileSystemObject` etc). Also it supports application events to implement two way communication with external apps and processes. 271 | 272 | This module allows taking the best from the two worlds - you may now use **npm** modules in your WScript scripts. Or, if you have bunch of legacy JScript sources, you may now execute them using this **NodeJS**-based runtime. 273 | 274 | If you install this package with -g key, you will have `nodewscript` command. 275 | 276 | Usage: 277 | ``` 278 | nodewscript [options] 279 | ``` 280 | 281 | Its direct analog in the windows scripting host is `cscript.exe` (it it outputs to the console, and `WScript.Echo` writes a line instead of showing a popup window). 282 | 283 | Where `Filename.js` is a file designed for windows scripting host. 284 | 285 | ## WScript Limitations 286 | 287 | ### Implicit Properties 288 | 289 | This is a key drawback of v8 engine compared to MS. Consider an example: 290 | 291 | ```javascript 292 | var a = WScript.CreateObject(...) 293 | if( a.Prop ) 294 | { 295 | // If 'Prop' is a dynamic property (i.e. it is not defined in TypeInfo and 296 | // not marked explicitly as a property, then execution never gets here. Even if a.Prop is null or false. 297 | } 298 | ``` 299 | 300 | ### Function Setters 301 | 302 | ```javascript 303 | var WshShell = new ActiveXObject("WScript.Shell"); 304 | var processEnv = WshShell.Environment("PROCESS"); 305 | processEnv("ENV_VAR") = "CUSTOM_VALUE"; // This syntax is valid for JScript, but will throw syntax error on v8 306 | ``` 307 | ### Events & Sleep 308 | 309 | Default WScript engine checks for events every time you do some sync operation or Sleep. In this implementation we check for events when `WScript.Sleep` is executed. 310 | 311 | ### 32 vs 64 Bit 312 | 313 | It is using the same bitness as installed version of the nodejs. So if your JScript files are designed for 32 bit, make sure to have nodejs x86 version installed before installing the **winax**. 314 | 315 | 316 | # Tests 317 | 318 | [mocha](https://github.com/visionmedia/mocha) is required to run unit tests. 319 | ``` 320 | npm install -g mocha 321 | mocha --expose-gc test 322 | ``` 323 | 324 | # Contributors 325 | 326 | * [durs](https://github.com/durs) 327 | * [somanuell](https://github.com/somanuell) 328 | * [Daniel-Userlane](https://github.com/Daniel-Userlane) 329 | * [alexeygrinevich](https://github.com/alexeygrinevich) 330 | -------------------------------------------------------------------------------- /activex.js: -------------------------------------------------------------------------------- 1 | var ActiveX = module.exports = require('./build/Release/node_activex.node'); 2 | 3 | global.ActiveXObject = function(id, opt) { 4 | return new ActiveX.Object(id, opt); 5 | }; 6 | -------------------------------------------------------------------------------- /binding.gyp: -------------------------------------------------------------------------------- 1 | { 2 | 'targets': [ 3 | { 4 | 'target_name': 'node_activex', 5 | 'conditions': [ 6 | ['OS=="win"', { 7 | 'sources': [ 8 | 'src/main.cpp', 9 | 'src/utils.cpp', 10 | 'src/disp.cpp' 11 | ], 12 | 'libraries': [], 13 | 'dependencies': [] 14 | }] 15 | ] 16 | } 17 | ] 18 | } -------------------------------------------------------------------------------- /data/test.xltm: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/durs/node-activex/d7a13a0b030af1783779be3b39f4672d1f26569c/data/test.xltm -------------------------------------------------------------------------------- /examples/ado.js: -------------------------------------------------------------------------------- 1 | //------------------------------------------------------------------------------------------------------- 2 | // Project: node-activex 3 | // Author: Yuri Dursin 4 | // Description: Example of using ActiveX addon with ADO 5 | //------------------------------------------------------------------------------------------------------- 6 | 7 | //require('winax'); 8 | require('../activex'); 9 | 10 | var path = require('path'); 11 | var data_path = path.join(__dirname, '../data/'); 12 | var filename = "persons.dbf"; 13 | var constr = "Provider=Microsoft.ACE.OLEDB.12.0;Data Source=" + data_path + ";Extended Properties=\"DBASE IV;\""; 14 | 15 | console.log("==> Preapre directory and delete DBF file on exists"); 16 | var fso = new ActiveXObject("Scripting.FileSystemObject"); 17 | if (!fso.FolderExists(data_path)) fso.CreateFolder(data_path); 18 | if (fso.FileExists(data_path + filename)) fso.DeleteFile(data_path + filename); 19 | 20 | console.log("==> Open connection"); 21 | var con = new ActiveXObject("ADODB.Connection"); 22 | console.log("ADO version: " + con.Version); 23 | con.Open(constr, "", ""); 24 | 25 | console.log("==> Create new DBF file") 26 | con.Execute("create Table " + filename + " (Name char(50), City char(50), Phone char(20), Zip decimal(5))"); 27 | 28 | console.log("==> Insert records to DBF") 29 | con.Execute("insert into " + filename + " values('John', 'London','123-45-67','14589')"); 30 | con.Execute("insert into " + filename + " values('Andrew', 'Paris','333-44-55','38215')"); 31 | con.Execute("insert into " + filename + " values('Romeo', 'Rom','222-33-44','54323')"); 32 | 33 | console.log("==> Select records from DBF") 34 | var rs = con.Execute("Select * from " + filename); 35 | var fields = rs.Fields; 36 | console.log("Result field count: " + fields.Count); 37 | console.log("Result record count: " + rs.RecordCount); 38 | 39 | rs.MoveFirst(); 40 | while (!rs.EOF) { 41 | // Access as property by string key 42 | var name = fields["Name"].Value; 43 | 44 | // Access as method with string argument 45 | var town = fields("City").value; 46 | 47 | // Access as indexed array 48 | var phone = fields[2].value; 49 | var zip = fields[3].value; 50 | 51 | console.log("> Person: "+name+" from " + town + " phone: " + phone + " zip: " + zip); 52 | rs.MoveNext(); 53 | } 54 | 55 | con.Close(); 56 | -------------------------------------------------------------------------------- /examples/event.js: -------------------------------------------------------------------------------- 1 | var winax = require('..'); 2 | var interval = setInterval(function () { 3 | winax.peekAndDispatchMessages(); // allows ActiveX event to be dispatched 4 | }, 50); 5 | 6 | var application = new ActiveXObject('Excel.Application'); 7 | 8 | var connectionPoints = winax.getConnectionPoints(application); 9 | var connectionPoint = connectionPoints[0]; 10 | 11 | // Excel Application events: https://docs.microsoft.com/en-us/office/vba/api/excel.application(object)#events 12 | connectionPoint.advise({ 13 | WindowActivate: function (workbook, win) { 14 | console.log('WindowActivate event triggerred'); 15 | }, 16 | WindowDeactivate: function (workbook, win) { 17 | console.log('WindowDeactivate event triggerred'); 18 | }, 19 | WindowResize: function (workbook, win) { 20 | console.log('WindowResize event triggerred'); 21 | }, 22 | NewWorkbook: function (workbook) { 23 | console.log('NewWorkbook event triggerred'); 24 | var worksheet = workbook.Worksheets(1); 25 | if (worksheet) { 26 | var cell = worksheet.Cells(1, 1); 27 | if (cell) { 28 | cell.value = "Hello world"; 29 | } 30 | } 31 | }, 32 | SheetActivate: function (worksheet) { 33 | console.log('SheetActivate event triggerred'); 34 | }, 35 | SheetDeactivate: function (worksheet) { 36 | console.log('SheetDeactivate event triggerred'); 37 | }, 38 | SheetSelectionChange: function (worksheet, range) { 39 | //var worksheet1 = range; // it's a bug now: args in reversal order 40 | //var range = worksheet; 41 | console.log('SheetSelectionChange event triggerred', range.Address); 42 | }, 43 | SheetChange: function (worksheet, range) { 44 | //var worksheet1 = range; // it's a bug now: args in reversal order 45 | //var range = worksheet; 46 | console.log('SheetChange event triggerred', range.Address, range.Value); 47 | }, 48 | }); 49 | 50 | application.Visible = true; 51 | console.log('Excel application has been open.'); 52 | console.log('--> Please create a new workbook to trigger event "NewWorkbook"'); 53 | 54 | setTimeout(function () { 55 | clearInterval(interval); 56 | application.Quit(); 57 | winax.release(application); 58 | }, 1000 * 60); 59 | 60 | -------------------------------------------------------------------------------- /examples/wbem.js: -------------------------------------------------------------------------------- 1 | var ActiveX = require('../activex'); 2 | var conn = new ActiveX.Object('WbemScripting.SWbemLocator'); 3 | var svr = conn.ConnectServer('.', '\\root\\cimv2'); 4 | const resp = svr.ExecQuery('SELECT ProcessorId FROM Win32_Processor'); 5 | for (let i = 0; i < resp.Count; i += 1) { 6 | const properties = resp.ItemIndex(i).Properties_; 7 | let count = properties.Count; 8 | const propEnum = properties._NewEnum; 9 | while (count--) { 10 | const prop = propEnum.Next(); 11 | if (prop) console.log(prop.Name + '=' + prop.Value); 12 | } 13 | } -------------------------------------------------------------------------------- /include/node_activex.h: -------------------------------------------------------------------------------- 1 | #pragma once 2 | 3 | // Include all the relevant definitions for use of the library code in a dependency. 4 | // Note that this does use the namespaces v8 and node in the current configuration 5 | 6 | #include "../src/stdafx.h" 7 | #include "../src/disp.h" 8 | #include "../src/utils.h" 9 | -------------------------------------------------------------------------------- /index.d.ts: -------------------------------------------------------------------------------- 1 | export class Object { 2 | constructor(id: string, options?: ActiveXObjectOptions); 3 | 4 | // Define properties typically found on COM objects 5 | __id?: string; 6 | __value?: any; 7 | __type?: any[]; 8 | __methods?: string[]; 9 | __vars?: string[]; 10 | 11 | // Define general method signatures if any known 12 | [key: string]: any; 13 | } 14 | 15 | /** @deprecated Use `ActiveXObjectOptions` instead. */ 16 | export interface ActiveXOptions extends ActiveXObjectOptions {} 17 | 18 | export class Variant { 19 | constructor(value?: any, type?: VariantType); 20 | assign(value: any): void; 21 | cast(type: VariantType): void; 22 | clear(): void; 23 | valueOf(): any; 24 | } 25 | 26 | export type VariantType = 27 | | 'int' | 'uint' | 'int8' | 'char' | 'uint8' | 'uchar' | 'byte' 28 | | 'int16' | 'short' | 'uint16' | 'ushort' 29 | | 'int32' | 'uint32' 30 | | 'int64' | 'long' | 'uint64' | 'ulong' 31 | | 'currency' | 'float' | 'double' | 'string' 32 | | 'date' | 'decimal' | 'variant' | 'null' | 'empty' 33 | | 'byref' | 'pbyref'; 34 | 35 | export function cast(value: any, type: VariantType): any; 36 | 37 | // Utility function to release COM objects 38 | export function release(...objects: any[]): void; 39 | 40 | declare global { 41 | function ActiveXObject(id: string, options?: ActiveXObjectOptions): any; 42 | function ActiveXObject(obj: Record): any; 43 | 44 | interface ActiveXObjectOptions { 45 | /** Allow activating existing object instance. */ 46 | activate?: boolean; 47 | 48 | /** Allow using the name of the file in the ROT. **/ 49 | getobject?: boolean; 50 | 51 | /** Allow using type information. */ 52 | type?: boolean; 53 | } 54 | } 55 | -------------------------------------------------------------------------------- /index.js: -------------------------------------------------------------------------------- 1 | module.exports = require('./activex'); -------------------------------------------------------------------------------- /lib_binding.gyp: -------------------------------------------------------------------------------- 1 | { 2 | 'targets': [ 3 | { 4 | 'target_name': 'lib_node_activex', 5 | 'type': 'static_library', 6 | 'sources': [ 7 | 'src/utils.cpp', 8 | 'src/disp.cpp' 9 | ], 10 | 'defines': [ 11 | 'BUILDING_NODE_EXTENSION', 12 | ], 13 | 'direct_dependent_settings': { 14 | 'include_dirs': ['include'] 15 | }, 16 | 'dependencies': [ 17 | ] 18 | } 19 | ] 20 | } 21 | -------------------------------------------------------------------------------- /package-lock.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "winax", 3 | "version": "3.5.3", 4 | "lockfileVersion": 2, 5 | "requires": true, 6 | "packages": { 7 | "": { 8 | "name": "winax", 9 | "version": "3.5.3", 10 | "license": "MIT", 11 | "bin": { 12 | "nodewscript": "NodeWScript.js" 13 | }, 14 | "devDependencies": {}, 15 | "engines": { 16 | "node": ">= 10.0.0" 17 | } 18 | } 19 | } 20 | } 21 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "winax", 3 | "version": "3.6.1", 4 | "description": "Windows COM bindings", 5 | "homepage": "https://github.com/durs/node-activex", 6 | "keywords": [ 7 | "OLE", 8 | "COM", 9 | "ActiveX", 10 | "ActiveXObject", 11 | "CreateObject", 12 | "Variant", 13 | "Dispatch", 14 | "WSH", 15 | "WMI", 16 | "Excel", 17 | "Word", 18 | "WScript", 19 | "ConnectObject", 20 | "DisconnectObject" 21 | ], 22 | "author": { 23 | "name": "Yuri Dursin", 24 | "url": "https://github.com/durs", 25 | "email": "yuri.dursin@gmail.com" 26 | }, 27 | "bin": { 28 | "nodewscript": "./NodeWScript.js" 29 | }, 30 | "contributors": [ 31 | "Yuri Dursin ", 32 | "Somanuell", 33 | "Daniel-Userlane", 34 | "Alexey Grinevich " 35 | ], 36 | "repository": { 37 | "type": "git", 38 | "url": "git://github.com/durs/node-activex.git" 39 | }, 40 | "dependencies": {}, 41 | "devDependencies": {}, 42 | "engines": { 43 | "node": ">= 10.0.0" 44 | }, 45 | "scripts": { 46 | "test": "mocha test" 47 | }, 48 | "license": "MIT", 49 | "main": "index.js" 50 | } 51 | -------------------------------------------------------------------------------- /src/disp.cpp: -------------------------------------------------------------------------------- 1 | //------------------------------------------------------------------------------------------------------- 2 | // Project: NodeActiveX 3 | // Author: Yuri Dursin 4 | // Description: DispObject class implementations 5 | //------------------------------------------------------------------------------------------------------- 6 | 7 | #include "stdafx.h" 8 | #include "disp.h" 9 | 10 | Persistent DispObject::inst_template; 11 | Persistent DispObject::clazz_template; 12 | NodeMethods DispObject::clazz_methods; 13 | 14 | Persistent VariantObject::inst_template; 15 | Persistent VariantObject::clazz_template; 16 | NodeMethods VariantObject::clazz_methods; 17 | 18 | Persistent ConnectionPointObject::inst_template; 19 | Persistent ConnectionPointObject::clazz_template; 20 | 21 | //------------------------------------------------------------------------------------------------------- 22 | // DispObject implemetation 23 | 24 | DispObject::DispObject(const DispInfoPtr &ptr, const std::wstring &nm, DISPID id, LONG indx, int opt) 25 | : disp(ptr), options((ptr->options & option_mask) | opt), name(nm), dispid(id), index(indx) 26 | { 27 | if (dispid == DISPID_UNKNOWN) { 28 | dispid = DISPID_VALUE; 29 | options |= option_prepared; 30 | } 31 | else options |= option_owned; 32 | NODE_DEBUG_FMT("DispObject '%S' constructor", name.c_str()); 33 | } 34 | 35 | DispObject::~DispObject() { 36 | items.Reset(); 37 | methods.Reset(); 38 | vars.Reset(); 39 | NODE_DEBUG_FMT("DispObject '%S' destructor", name.c_str()); 40 | } 41 | 42 | HRESULT DispObject::prepare() { 43 | CComVariant value; 44 | HRESULT hrcode = disp ? disp->GetProperty(dispid, index, &value) : E_UNEXPECTED; 45 | 46 | // Init dispatch interface 47 | options |= option_prepared; 48 | CComPtr ptr; 49 | if (VariantDispGet(&value, &ptr)) { 50 | disp.reset(new DispInfo(ptr, name, options, &disp)); 51 | dispid = DISPID_VALUE; 52 | } 53 | else if ((value.vt & VT_ARRAY) != 0) { 54 | 55 | } 56 | return hrcode; 57 | } 58 | 59 | bool DispObject::release() { 60 | if (!disp) return false; 61 | NODE_DEBUG_FMT("DispObject '%S' release", name.c_str()); 62 | disp.reset(); 63 | items.Reset(); 64 | methods.Reset(); 65 | vars.Reset(); 66 | return true; 67 | } 68 | 69 | bool DispObject::get(LPOLESTR tag, LONG index, const PropertyCallbackInfoGetter &args) { 70 | Isolate *isolate = args.GetIsolate(); 71 | if (!is_prepared()) prepare(); 72 | if (!disp) { 73 | isolate->ThrowException(DispErrorNull(isolate)); 74 | return false; 75 | } 76 | 77 | // Search dispid 78 | HRESULT hrcode; 79 | DISPID propid; 80 | bool prop_by_key = false; 81 | bool this_prop = false; 82 | if (!tag || !*tag) { 83 | tag = (LPOLESTR)name.c_str(); 84 | propid = dispid; 85 | this_prop = true; 86 | } 87 | else { 88 | hrcode = disp->FindProperty(tag, &propid); 89 | if (SUCCEEDED(hrcode) && propid == DISPID_UNKNOWN) hrcode = E_INVALIDARG; 90 | if FAILED(hrcode) { 91 | prop_by_key = (options & option_property) != 0; 92 | if (!prop_by_key) { 93 | //isolate->ThrowException(DispError(isolate, hrcode, L"DispPropertyFind", tag)); 94 | args.GetReturnValue().SetUndefined(); 95 | return false; 96 | } 97 | propid = dispid; 98 | } 99 | } 100 | 101 | // Check type info 102 | int opt = 0; 103 | bool is_property_simple = false; 104 | if (prop_by_key) { 105 | is_property_simple = true; 106 | opt |= option_property; 107 | } 108 | else { 109 | DispInfo::type_ptr disp_info; 110 | if (disp->GetTypeInfo(propid, disp_info)) { 111 | if (disp_info->is_function_simple()) opt |= option_function_simple; 112 | else { 113 | if (disp_info->is_property()) opt |= option_property; 114 | is_property_simple = disp_info->is_property_simple(); 115 | 116 | if (disp->bManaged && tag && *tag && wcscmp(tag, L"ToString")==0) 117 | { 118 | // .NET ToString is reported as a property while we normally use it via .ToString() - i.e. as a method. 119 | is_property_simple = false; 120 | } 121 | 122 | } 123 | } 124 | else if ( disp->bManaged && tag && *tag && wcscmp(tag, L"length") == 0) { 125 | DISPID lenprop; 126 | if SUCCEEDED(disp->FindProperty((LPOLESTR)L"length", &lenprop)) { 127 | 128 | // If we have 'IReflect' and '.length' - assume it is .NET JS Array or JS Object 129 | is_property_simple = true; 130 | } 131 | } 132 | else if (disp->bManaged && tag && *tag && index>=0 ) { 133 | // jsarray[x] 134 | is_property_simple = true; 135 | } 136 | } 137 | 138 | // Return as property value 139 | if (is_property_simple) { 140 | CComException except; 141 | CComVariant value; 142 | VarArguments vargs; 143 | if (prop_by_key) vargs.items.push_back(CComVariant(tag)); 144 | if (index >= 0) vargs.items.push_back(CComVariant(index)); 145 | LONG argcnt = (LONG)vargs.items.size(); 146 | VARIANT *pargs = (argcnt > 0) ? &vargs.items.front() : 0; 147 | hrcode = disp->GetProperty(propid, argcnt, pargs, &value, &except); 148 | if (FAILED(hrcode) && dispid != DISPID_VALUE){ 149 | isolate->ThrowException(DispError(isolate, hrcode, L"DispPropertyGet", tag, &except)); 150 | return false; 151 | } 152 | CComPtr ptr; 153 | if (VariantDispGet(&value, &ptr)) { 154 | DispInfoPtr disp_result(new DispInfo(ptr, tag, options, &disp)); 155 | Local