add app.setLocale() (#11469)

* infrastructure for setLocale via klang

* add documentation for setLocale

* add test for setLocale

* fix spec

* add spec and update docs

* fix carriage feeds on windows

* SetLocale() sets LC_ALL on Linux

* in SetLocale() on Linux, use g_setenv()

* fix tyop: '#ifdef OSX_POSIX'

* make the linter happy

* improvements from review

spec/api-app-spec.js

@@ -112,6 +112,25 @@ describe('app module', () => {
     })
   })
 
+  describe('app.setLocale()', () => {
+    const testLocale = (locale, result, done) => {
+      const appPath = path.join(__dirname, 'fixtures', 'api', 'locale-check')
+      const electronPath = remote.getGlobal('process').execPath
+      let output = ''
+      let appProcess = ChildProcess.spawn(electronPath, [appPath, `--lang=${locale}`])
+
+      appProcess.stdout.on('data', (data) => { output += data })
+      appProcess.stdout.on('end', () => {
+        output = output.replace(/(\r\n|\n|\r)/gm, '')
+        assert.equal(output, result)
+        done()
+      })
+    }
+
+    it('should set the locale', (done) => testLocale('fr', 'fr', done))
+    it('should not set an invalid locale', (done) => testLocale('asdfkl', 'en-US', done))
+  })
+
   describe('app.isInApplicationsFolder()', () => {
     before(function () {
       if (process.platform !== 'darwin') {

spec/fixtures/api/locale-check/main.js

@@ -0,0 +1,10 @@
+const {app} = require('electron')
+
+app.on('ready', () => {
+  process.stdout.write(app.getLocale())
+  process.stdout.end()
+
+  setImmediate(() => {
+    app.quit()
+  })
+})

spec/fixtures/api/locale-check/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "locale-check",
+  "main": "main.js"
+}
+