338 lines
13 KiB
TypeScript
338 lines
13 KiB
TypeScript
import { expect } from 'chai';
|
|
import { systemPreferences } from 'electron/main';
|
|
import { expectDeprecationMessages } from './lib/deprecate-helpers';
|
|
import { ifdescribe } from './lib/spec-helpers';
|
|
|
|
describe('systemPreferences module', () => {
|
|
ifdescribe(process.platform === 'win32')('systemPreferences.getAccentColor', () => {
|
|
it('should return a non-empty string', () => {
|
|
const accentColor = systemPreferences.getAccentColor();
|
|
expect(accentColor).to.be.a('string').that.is.not.empty('accent color');
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'win32')('systemPreferences.getColor(id)', () => {
|
|
it('throws an error when the id is invalid', () => {
|
|
expect(() => {
|
|
systemPreferences.getColor('not-a-color' as any);
|
|
}).to.throw('Unknown color: not-a-color');
|
|
});
|
|
|
|
it('returns a hex RGB color string', () => {
|
|
expect(systemPreferences.getColor('window')).to.match(/^#[0-9A-F]{6}$/i);
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.registerDefaults(defaults)', () => {
|
|
it('registers defaults', () => {
|
|
const defaultsMap = [
|
|
{ key: 'one', type: 'string', value: 'ONE' },
|
|
{ key: 'two', value: 2, type: 'integer' },
|
|
{ key: 'three', value: [1, 2, 3], type: 'array' }
|
|
] as const;
|
|
|
|
const defaultsDict: Record<string, any> = {};
|
|
defaultsMap.forEach(row => { defaultsDict[row.key] = row.value; });
|
|
|
|
systemPreferences.registerDefaults(defaultsDict);
|
|
|
|
for (const userDefault of defaultsMap) {
|
|
const { key, value: expectedValue, type } = userDefault;
|
|
const actualValue = systemPreferences.getUserDefault(key, type);
|
|
expect(actualValue).to.deep.equal(expectedValue);
|
|
}
|
|
});
|
|
|
|
it('throws when bad defaults are passed', () => {
|
|
const badDefaults = [
|
|
1,
|
|
null,
|
|
{ one: null }
|
|
];
|
|
|
|
for (const badDefault of badDefaults) {
|
|
expect(() => {
|
|
systemPreferences.registerDefaults(badDefault as any);
|
|
}).to.throw('Error processing argument at index 0, conversion failure from ');
|
|
}
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.getUserDefault(key, type)', () => {
|
|
it('returns values for known user defaults', () => {
|
|
const locale = systemPreferences.getUserDefault('AppleLocale', 'string');
|
|
expect(locale).to.be.a('string').that.is.not.empty('locale');
|
|
|
|
const languages = systemPreferences.getUserDefault('AppleLanguages', 'array');
|
|
expect(languages).to.be.an('array').that.is.not.empty('languages');
|
|
});
|
|
|
|
it('returns values for unknown user defaults', () => {
|
|
expect(systemPreferences.getUserDefault('UserDefaultDoesNotExist', 'boolean')).to.equal(false);
|
|
expect(systemPreferences.getUserDefault('UserDefaultDoesNotExist', 'integer')).to.equal(0);
|
|
expect(systemPreferences.getUserDefault('UserDefaultDoesNotExist', 'float')).to.equal(0);
|
|
expect(systemPreferences.getUserDefault('UserDefaultDoesNotExist', 'double')).to.equal(0);
|
|
expect(systemPreferences.getUserDefault('UserDefaultDoesNotExist', 'string')).to.equal('');
|
|
expect(systemPreferences.getUserDefault('UserDefaultDoesNotExist', 'url')).to.equal('');
|
|
expect(systemPreferences.getUserDefault('UserDefaultDoesNotExist', 'badtype' as any)).to.be.undefined('user default');
|
|
expect(systemPreferences.getUserDefault('UserDefaultDoesNotExist', 'array')).to.deep.equal([]);
|
|
expect(systemPreferences.getUserDefault('UserDefaultDoesNotExist', 'dictionary')).to.deep.equal({});
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.setUserDefault(key, type, value)', () => {
|
|
const KEY = 'SystemPreferencesTest';
|
|
const TEST_CASES = [
|
|
['string', 'abc'],
|
|
['boolean', true],
|
|
['float', 2.5],
|
|
['double', 10.1],
|
|
['integer', 11],
|
|
['url', 'https://github.com/electron'],
|
|
['array', [1, 2, 3]],
|
|
['dictionary', { a: 1, b: 2 }]
|
|
] as const;
|
|
|
|
it('sets values', () => {
|
|
for (const [type, value] of TEST_CASES) {
|
|
systemPreferences.setUserDefault(KEY, type, value as any);
|
|
const retrievedValue = systemPreferences.getUserDefault(KEY, type);
|
|
expect(retrievedValue).to.deep.equal(value);
|
|
}
|
|
});
|
|
|
|
it('throws when type and value conflict', () => {
|
|
for (const [type, value] of TEST_CASES) {
|
|
expect(() => {
|
|
systemPreferences.setUserDefault(KEY, type, typeof value === 'string' ? {} : 'foo' as any);
|
|
}).to.throw(`Unable to convert value to: ${type}`);
|
|
}
|
|
});
|
|
|
|
it('throws when type is not valid', () => {
|
|
expect(() => {
|
|
systemPreferences.setUserDefault(KEY, 'abc' as any, 'foo');
|
|
}).to.throw('Invalid type: abc');
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.subscribeNotification(event, callback)', () => {
|
|
it('throws an error if invalid arguments are passed', () => {
|
|
const badArgs = [123, {}, ['hi', 'bye'], new Date()];
|
|
for (const bad of badArgs) {
|
|
expect(() => {
|
|
systemPreferences.subscribeNotification(bad as any, () => {});
|
|
}).to.throw('Must pass null or a string');
|
|
}
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.subscribeLocalNotification(event, callback)', () => {
|
|
it('throws an error if invalid arguments are passed', () => {
|
|
const badArgs = [123, {}, ['hi', 'bye'], new Date()];
|
|
for (const bad of badArgs) {
|
|
expect(() => {
|
|
systemPreferences.subscribeNotification(bad as any, () => {});
|
|
}).to.throw('Must pass null or a string');
|
|
}
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.subscribeWorkspaceNotification(event, callback)', () => {
|
|
it('throws an error if invalid arguments are passed', () => {
|
|
const badArgs = [123, {}, ['hi', 'bye'], new Date()];
|
|
for (const bad of badArgs) {
|
|
expect(() => {
|
|
systemPreferences.subscribeWorkspaceNotification(bad as any, () => {});
|
|
}).to.throw('Must pass null or a string');
|
|
}
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.getSystemColor(color)', () => {
|
|
it('throws on invalid system colors', () => {
|
|
const color = 'bad-color';
|
|
expect(() => {
|
|
systemPreferences.getSystemColor(color as any);
|
|
}).to.throw(`Unknown system color: ${color}`);
|
|
});
|
|
|
|
it('returns a valid system color', () => {
|
|
const colors = ['blue', 'brown', 'gray', 'green', 'orange', 'pink', 'purple', 'red', 'yellow'] as const;
|
|
|
|
colors.forEach(color => {
|
|
const sysColor = systemPreferences.getSystemColor(color);
|
|
expect(sysColor).to.be.a('string');
|
|
});
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.getColor(color)', () => {
|
|
it('throws on invalid colors', () => {
|
|
const color = 'bad-color';
|
|
expect(() => {
|
|
systemPreferences.getColor(color as any);
|
|
}).to.throw(`Unknown color: ${color}`);
|
|
});
|
|
|
|
it('returns a valid color', async () => {
|
|
const colors = [
|
|
'control-background',
|
|
'control',
|
|
'control-text',
|
|
'disabled-control-text',
|
|
'find-highlight',
|
|
'grid',
|
|
'header-text',
|
|
'highlight',
|
|
'keyboard-focus-indicator',
|
|
'label',
|
|
'link',
|
|
'placeholder-text',
|
|
'quaternary-label',
|
|
'scrubber-textured-background',
|
|
'secondary-label',
|
|
'selected-content-background',
|
|
'selected-control',
|
|
'selected-control-text',
|
|
'selected-menu-item-text',
|
|
'selected-text-background',
|
|
'selected-text',
|
|
'separator',
|
|
'shadow',
|
|
'tertiary-label',
|
|
'text-background',
|
|
'text',
|
|
'under-page-background',
|
|
'unemphasized-selected-content-background',
|
|
'unemphasized-selected-text-background',
|
|
'unemphasized-selected-text',
|
|
'window-background',
|
|
'window-frame-text'
|
|
] as const;
|
|
|
|
colors.forEach(color => {
|
|
const sysColor = systemPreferences.getColor(color);
|
|
expect(sysColor).to.be.a('string');
|
|
});
|
|
|
|
await expectDeprecationMessages(
|
|
() => {
|
|
const sysColor = systemPreferences.getColor('alternate-selected-control-text');
|
|
expect(sysColor).to.be.a('string');
|
|
},
|
|
"'alternate-selected-control-text' is deprecated as an input to getColor. Use 'selected-content-background' instead."
|
|
);
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.appLevelAppearance', () => {
|
|
const options = ['dark', 'light', 'unknown', null];
|
|
describe('with properties', () => {
|
|
it('returns a valid appearance', () => {
|
|
const appearance = systemPreferences.appLevelAppearance;
|
|
expect(options).to.include(appearance);
|
|
});
|
|
|
|
it('can be changed', () => {
|
|
systemPreferences.appLevelAppearance = 'dark';
|
|
expect(systemPreferences.appLevelAppearance).to.eql('dark');
|
|
});
|
|
});
|
|
|
|
describe('with functions', () => {
|
|
it('returns a valid appearance', async () => {
|
|
await expectDeprecationMessages(
|
|
() => {
|
|
const appearance = systemPreferences.getAppLevelAppearance();
|
|
expect(options).to.include(appearance);
|
|
},
|
|
"(electron) 'getAppLevelAppearance function' is deprecated and will be removed."
|
|
);
|
|
});
|
|
|
|
it('can be changed', async () => {
|
|
await expectDeprecationMessages(
|
|
() => {
|
|
systemPreferences.setAppLevelAppearance('dark');
|
|
const appearance = systemPreferences.getAppLevelAppearance();
|
|
expect(appearance).to.eql('dark');
|
|
},
|
|
"(electron) 'setAppLevelAppearance function' is deprecated and will be removed."
|
|
);
|
|
});
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.effectiveAppearance', () => {
|
|
const options = ['dark', 'light', 'unknown'];
|
|
describe('with properties', () => {
|
|
it('returns a valid appearance', () => {
|
|
const appearance = systemPreferences.effectiveAppearance;
|
|
expect(options).to.include(appearance);
|
|
});
|
|
});
|
|
|
|
describe('with functions', () => {
|
|
it('returns a valid appearance', () => {
|
|
const appearance = systemPreferences.getEffectiveAppearance();
|
|
expect(options).to.include(appearance);
|
|
});
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.setUserDefault(key, type, value)', () => {
|
|
it('removes keys', () => {
|
|
const KEY = 'SystemPreferencesTest';
|
|
systemPreferences.setUserDefault(KEY, 'string', 'foo');
|
|
systemPreferences.removeUserDefault(KEY);
|
|
expect(systemPreferences.getUserDefault(KEY, 'string')).to.equal('');
|
|
});
|
|
|
|
it('does not throw for missing keys', () => {
|
|
systemPreferences.removeUserDefault('some-missing-key');
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.canPromptTouchID()', () => {
|
|
it('returns a boolean', () => {
|
|
expect(systemPreferences.canPromptTouchID()).to.be.a('boolean');
|
|
});
|
|
});
|
|
|
|
ifdescribe(process.platform === 'darwin')('systemPreferences.isTrustedAccessibilityClient(prompt)', () => {
|
|
it('returns a boolean', () => {
|
|
const trusted = systemPreferences.isTrustedAccessibilityClient(false);
|
|
expect(trusted).to.be.a('boolean');
|
|
});
|
|
});
|
|
|
|
ifdescribe(['win32', 'darwin'].includes(process.platform))('systemPreferences.getMediaAccessStatus(mediaType)', () => {
|
|
const statuses = ['not-determined', 'granted', 'denied', 'restricted', 'unknown'];
|
|
|
|
it('returns an access status for a camera access request', () => {
|
|
const cameraStatus = systemPreferences.getMediaAccessStatus('camera');
|
|
expect(statuses).to.include(cameraStatus);
|
|
});
|
|
|
|
it('returns an access status for a microphone access request', () => {
|
|
const microphoneStatus = systemPreferences.getMediaAccessStatus('microphone');
|
|
expect(statuses).to.include(microphoneStatus);
|
|
});
|
|
|
|
it('returns an access status for a screen access request', () => {
|
|
const screenStatus = systemPreferences.getMediaAccessStatus('screen');
|
|
expect(statuses).to.include(screenStatus);
|
|
});
|
|
});
|
|
|
|
describe('systemPreferences.getAnimationSettings()', () => {
|
|
it('returns an object with all properties', () => {
|
|
const settings = systemPreferences.getAnimationSettings();
|
|
expect(settings).to.be.an('object');
|
|
expect(settings).to.have.property('shouldRenderRichAnimation').that.is.a('boolean');
|
|
expect(settings).to.have.property('scrollAnimationsEnabledBySystem').that.is.a('boolean');
|
|
expect(settings).to.have.property('prefersReducedMotion').that.is.a('boolean');
|
|
});
|
|
});
|
|
});
|