import { editor as monacoEditor, languages as monacoLanguages, Uri } from 'monaco-editor'; import Editor from '~/editor/editor_lite'; import { DEFAULT_THEME, themes } from '~/ide/lib/themes'; import { EDITOR_LITE_INSTANCE_ERROR_NO_EL, URI_PREFIX } from '~/editor/constants'; describe('Base editor', () => { let editorEl; let editor; const blobContent = 'Foo Bar'; const blobPath = 'test.md'; const blobGlobalId = 'snippet_777'; const fakeModel = { foo: 'bar', dispose: jest.fn() }; beforeEach(() => { setFixtures('
'); editorEl = document.getElementById('editor'); editor = new Editor(); }); afterEach(() => { editor.dispose(); editorEl.remove(); }); const createUri = (...paths) => Uri.file([URI_PREFIX, ...paths].join('/')); it('initializes Editor with basic properties', () => { expect(editor).toBeDefined(); expect(editor.instances).toEqual([]); }); it('removes `editor-loading` data attribute from the target DOM element', () => { editor.createInstance({ el: editorEl }); expect(editorEl.dataset.editorLoading).toBeUndefined(); }); describe('instance of the Editor', () => { let modelSpy; let instanceSpy; let setModel; let dispose; beforeEach(() => { setModel = jest.fn(); dispose = jest.fn(); modelSpy = jest.spyOn(monacoEditor, 'createModel').mockImplementation(() => fakeModel); instanceSpy = jest.spyOn(monacoEditor, 'create').mockImplementation(() => ({ setModel, dispose, onDidDispose: jest.fn(), })); }); it('throws an error if no dom element is supplied', () => { expect(() => { editor.createInstance(); }).toThrow(EDITOR_LITE_INSTANCE_ERROR_NO_EL); expect(modelSpy).not.toHaveBeenCalled(); expect(instanceSpy).not.toHaveBeenCalled(); expect(setModel).not.toHaveBeenCalled(); }); it('creates model to be supplied to Monaco editor', () => { editor.createInstance({ el: editorEl, blobPath, blobContent }); expect(modelSpy).toHaveBeenCalledWith(blobContent, undefined, createUri(blobPath)); expect(setModel).toHaveBeenCalledWith(fakeModel); }); it('initializes the instance on a supplied DOM node', () => { editor.createInstance({ el: editorEl }); expect(editor.editorEl).not.toBe(null); expect(instanceSpy).toHaveBeenCalledWith(editorEl, expect.anything()); }); it('with blobGlobalId, creates model with id in uri', () => { editor.createInstance({ el: editorEl, blobPath, blobContent, blobGlobalId }); expect(modelSpy).toHaveBeenCalledWith( blobContent, undefined, createUri(blobGlobalId, blobPath), ); }); it('initializes instance with passed properties', () => { const instanceOptions = { foo: 'bar', }; editor.createInstance({ el: editorEl, ...instanceOptions, }); expect(instanceSpy).toHaveBeenCalledWith(editorEl, expect.objectContaining(instanceOptions)); }); it('disposes instance when the editor is disposed', () => { editor.createInstance({ el: editorEl, blobPath, blobContent, blobGlobalId }); expect(dispose).not.toHaveBeenCalled(); editor.dispose(); expect(dispose).toHaveBeenCalled(); }); }); describe('multiple instances', () => { let instanceSpy; let inst1Args; let inst2Args; let editorEl1; let editorEl2; let inst1; let inst2; const readOnlyIndex = '68'; // readOnly option has the internal index of 68 in the editor's options beforeEach(() => { setFixtures('
'); editorEl1 = document.getElementById('editor1'); editorEl2 = document.getElementById('editor2'); inst1Args = { el: editorEl1, blobGlobalId, }; inst2Args = { el: editorEl2, blobContent, blobPath, blobGlobalId, }; editor = new Editor(); instanceSpy = jest.spyOn(monacoEditor, 'create'); }); afterEach(() => { editor.dispose(); }); it('can initialize several instances of the same editor', () => { editor.createInstance(inst1Args); expect(editor.instances).toHaveLength(1); editor.createInstance(inst2Args); expect(instanceSpy).toHaveBeenCalledTimes(2); expect(editor.instances).toHaveLength(2); }); it('sets independent models on independent instances', () => { inst1 = editor.createInstance(inst1Args); inst2 = editor.createInstance(inst2Args); const model1 = inst1.getModel(); const model2 = inst2.getModel(); expect(model1).toBeDefined(); expect(model2).toBeDefined(); expect(model1).not.toEqual(model2); }); it('shares global editor options among all instances', () => { editor = new Editor({ readOnly: true, }); inst1 = editor.createInstance(inst1Args); expect(inst1.getOption(readOnlyIndex)).toBe(true); inst2 = editor.createInstance(inst2Args); expect(inst2.getOption(readOnlyIndex)).toBe(true); }); it('allows overriding editor options on the instance level', () => { editor = new Editor({ readOnly: true, }); inst1 = editor.createInstance({ ...inst1Args, readOnly: false, }); expect(inst1.getOption(readOnlyIndex)).toBe(false); }); it('disposes instances and relevant models independently from each other', () => { inst1 = editor.createInstance(inst1Args); inst2 = editor.createInstance(inst2Args); expect(inst1.getModel()).not.toBe(null); expect(inst2.getModel()).not.toBe(null); expect(editor.instances).toHaveLength(2); expect(monacoEditor.getModels()).toHaveLength(2); inst1.dispose(); expect(inst1.getModel()).toBe(null); expect(inst2.getModel()).not.toBe(null); expect(editor.instances).toHaveLength(1); expect(monacoEditor.getModels()).toHaveLength(1); }); }); describe('implementation', () => { let instance; beforeEach(() => { instance = editor.createInstance({ el: editorEl, blobPath, blobContent }); }); it('correctly proxies value from the model', () => { expect(instance.getValue()).toBe(blobContent); }); it('is capable of changing the language of the model', () => { // ignore warnings and errors Monaco posts during setup // (due to being called from Jest/Node.js environment) jest.spyOn(console, 'warn').mockImplementation(() => {}); jest.spyOn(console, 'error').mockImplementation(() => {}); const blobRenamedPath = 'test.js'; expect(instance.getModel().getLanguageIdentifier().language).toBe('markdown'); instance.updateModelLanguage(blobRenamedPath); expect(instance.getModel().getLanguageIdentifier().language).toBe('javascript'); }); it('falls back to plaintext if there is no language associated with an extension', () => { const blobRenamedPath = 'test.myext'; const spy = jest.spyOn(console, 'error').mockImplementation(() => {}); instance.updateModelLanguage(blobRenamedPath); expect(spy).not.toHaveBeenCalled(); expect(instance.getModel().getLanguageIdentifier().language).toBe('plaintext'); }); }); describe('extensions', () => { let instance; const foo1 = jest.fn(); const foo2 = jest.fn(); const bar = jest.fn(); const MyExt1 = { foo: foo1, }; const MyExt2 = { bar, }; const MyExt3 = { foo: foo2, }; beforeEach(() => { instance = editor.createInstance({ el: editorEl, blobPath, blobContent }); }); it('is extensible with the extensions', () => { expect(instance.foo).toBeUndefined(); editor.use(MyExt1); expect(instance.foo).toEqual(foo1); }); it('does not fail if no extensions supplied', () => { const spy = jest.spyOn(global.console, 'error'); editor.use(); expect(spy).not.toHaveBeenCalled(); }); it('is extensible with multiple extensions', () => { expect(instance.foo).toBeUndefined(); expect(instance.bar).toBeUndefined(); editor.use([MyExt1, MyExt2]); expect(instance.foo).toEqual(foo1); expect(instance.bar).toEqual(bar); }); it('uses the last definition of a method in case of an overlap', () => { editor.use([MyExt1, MyExt2, MyExt3]); expect(instance).toEqual( expect.objectContaining({ foo: foo2, bar, }), ); }); it('correctly resolves references withing extensions', () => { const FunctionExt = { inst() { return this; }, mod() { return this.getModel(); }, }; editor.use(FunctionExt); expect(instance.inst()).toEqual(editor.instances[0]); }); describe('multiple instances', () => { let inst1; let inst2; let editorEl1; let editorEl2; beforeEach(() => { setFixtures('
'); editorEl1 = document.getElementById('editor1'); editorEl2 = document.getElementById('editor2'); inst1 = editor.createInstance({ el: editorEl1, blobPath: `foo-${blobPath}` }); inst2 = editor.createInstance({ el: editorEl2, blobPath: `bar-${blobPath}` }); }); afterEach(() => { editor.dispose(); editorEl1.remove(); editorEl2.remove(); }); it('extends all instances if no specific instance is passed', () => { editor.use(MyExt1); expect(inst1.foo).toEqual(foo1); expect(inst2.foo).toEqual(foo1); }); it('extends specific instance if it has been passed', () => { editor.use(MyExt1, inst2); expect(inst1.foo).toBeUndefined(); expect(inst2.foo).toEqual(foo1); }); }); }); describe('languages', () => { it('registers custom languages defined with Monaco', () => { expect(monacoLanguages.getLanguages()).toEqual( expect.arrayContaining([ expect.objectContaining({ id: 'vue', }), ]), ); }); }); describe('syntax highlighting theme', () => { let themeDefineSpy; let themeSetSpy; let defaultScheme; beforeEach(() => { themeDefineSpy = jest.spyOn(monacoEditor, 'defineTheme').mockImplementation(() => {}); themeSetSpy = jest.spyOn(monacoEditor, 'setTheme').mockImplementation(() => {}); defaultScheme = window.gon.user_color_scheme; }); afterEach(() => { window.gon.user_color_scheme = defaultScheme; }); it('sets default syntax highlighting theme', () => { const expectedTheme = themes.find(t => t.name === DEFAULT_THEME); editor = new Editor(); expect(themeDefineSpy).toHaveBeenCalledWith(DEFAULT_THEME, expectedTheme.data); expect(themeSetSpy).toHaveBeenCalledWith(DEFAULT_THEME); }); it('sets correct theme if it is set in users preferences', () => { const expectedTheme = themes.find(t => t.name !== DEFAULT_THEME); expect(expectedTheme.name).not.toBe(DEFAULT_THEME); window.gon.user_color_scheme = expectedTheme.name; editor = new Editor(); expect(themeDefineSpy).toHaveBeenCalledWith(expectedTheme.name, expectedTheme.data); expect(themeSetSpy).toHaveBeenCalledWith(expectedTheme.name); }); it('falls back to default theme if a selected one is not supported yet', () => { const name = 'non-existent-theme'; const nonExistentTheme = { name }; window.gon.user_color_scheme = nonExistentTheme.name; editor = new Editor(); expect(themeDefineSpy).not.toHaveBeenCalled(); expect(themeSetSpy).toHaveBeenCalledWith(DEFAULT_THEME); }); }); });