refactor JS API

Question

refactor JS API

kfix opened this issue 9 years ago · 12 comments

kfix commented 9 years ago

Most of the API surface I want to use & support is now exposed, but its a bit clunky.

delegate:

should take advantage of ES6 classes so that one can initialize an App object from a class constructor and return that. Then ESlint can check for oopsies and IDEs can do code completion.
- delegate.{someNamedScriptMessageHandler} -> App().messageHandlers.{someName}(webview,...msg)
- delegate.launchURL(str) -> App().selectors.launch(...arguments)
- delegate.decideNavigationFoo(urlstr) -> App().webviewHooks.navigationFoo(webview, url)
  - ideally, one could attach hooks to specific web views from JS

$ is also vague and intones jQuery.

export a MacPin singleton?
- $.app -> MacPin.os, MacPin.process, MacPin.bundle
- $.browser -> MacPin.window
- $.browser.tabs -> MacPin.webviews

Answer 1 · 2015-12-07T00:01:09.000Z

extend and JSExport NSURL()s as URL(), behaving roughly like the URL() in most browser DOMs. That would standardize all the delegate methods and launch()

JS polyfills:

Answer 2 · 2015-12-07T04:00:24.000Z

this could be handy for aliasing some exported methods:
https://gist.github.com/zeitiger/1387f7d996f64b493608

Answer 3 · 2016-01-04T22:15:32.000Z

support fetch API instead of XMLHttpRequest??

Answer 4 · 2016-01-30T19:37:42.000Z

Its possible to renamed exported vars/funcs with @objc(betterJSName:) and exclude overloads with @nonobjc
https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/BuildingCocoaApps/InteractingWithObjective-CAPIs.html#//apple_ref/doc/uid/TP40014216-CH4-ID55

Answer 5 · 2016-02-13T01:47:59.000Z

another URI lib: https://github.com/medialize/URI.js
Consider including SystemJS/jspm, and allowing module loads before MacPin API is extended in.

Answer 6 · 2016-02-14T05:55:05.000Z

a good listing of available JS features: https://webkit.org/status/

Answer 7 · 2016-02-19T19:38:28.000Z

Chrome's chrome.tabs API is not synchronous at all.
Safari's is but doesn't support .push()ing a tab.

Both fire events for tab actions.

Answer 8 · 2016-03-13T19:30:02.000Z

rather than app.js having to explicitly return an object that will become the jsdelegate, this should just be that object.

Answer 9 · 2016-03-29T04:25:05.000Z

Firefox is going to support a majority of Chrome's API as 'chrome.'

https://github.com/mdn/webextensions-examples

Answer 10 · 2016-07-27T16:19:53.000Z

expose NSUserDefaults to app.js as localStorage()

Answer 11 · 2016-08-23T21:22:01.000Z

URL() is being added to WebCore (yay!) hopefully for Safari 10
macgap: https://github.com/MacGapProject/MacGap1/wiki/API-Reference

Answer 12 · 2017-04-22T22:10:07.000Z

nodejs APIs can be shimmed in:
https://github.com/nodekit-io/nodekit-darwin