@wordpress/e2e-tests 3.0.1-next.33ec3857e2.0 → 3.0.1

package/specs/editor/various/__snapshots__/block-editor-keyboard-shortcuts.test.js.snap

@@ -2,112 +2,126 @@
 
 exports[`block editor keyboard shortcuts move blocks multiple blocks selected should move the blocks down 1`] = `
 "<!-- wp:paragraph -->
-<p>First paragraph</p>
+<p>1st</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Second paragraph</p>
+<p>2nd</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Third paragraph</p>
+<p>3rd</p>
 <!-- /wp:paragraph -->"
 `;
 
 exports[`block editor keyboard shortcuts move blocks multiple blocks selected should move the blocks down 2`] = `
 "<!-- wp:paragraph -->
-<p>Third paragraph</p>
+<p>3rd</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>First paragraph</p>
+<p>1st</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Second paragraph</p>
+<p>2nd</p>
 <!-- /wp:paragraph -->"
 `;
 
 exports[`block editor keyboard shortcuts move blocks multiple blocks selected should move the blocks up 1`] = `
 "<!-- wp:paragraph -->
-<p>First paragraph</p>
+<p>1st</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Second paragraph</p>
+<p>2nd</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Third paragraph</p>
+<p>3rd</p>
 <!-- /wp:paragraph -->"
 `;
 
 exports[`block editor keyboard shortcuts move blocks multiple blocks selected should move the blocks up 2`] = `
 "<!-- wp:paragraph -->
-<p>Second paragraph</p>
+<p>2nd</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Third paragraph</p>
+<p>3rd</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>First paragraph</p>
+<p>1st</p>
 <!-- /wp:paragraph -->"
 `;
 
 exports[`block editor keyboard shortcuts move blocks single block selected should move the block down 1`] = `
 "<!-- wp:paragraph -->
-<p>First paragraph</p>
+<p>1st</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Second paragraph</p>
+<p>2nd</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Third paragraph</p>
+<p>3rd</p>
 <!-- /wp:paragraph -->"
 `;
 
 exports[`block editor keyboard shortcuts move blocks single block selected should move the block down 2`] = `
 "<!-- wp:paragraph -->
-<p>First paragraph</p>
+<p>1st</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Third paragraph</p>
+<p>3rd</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Second paragraph</p>
+<p>2nd</p>
 <!-- /wp:paragraph -->"
 `;
 
 exports[`block editor keyboard shortcuts move blocks single block selected should move the block up 1`] = `
 "<!-- wp:paragraph -->
-<p>First paragraph</p>
+<p>1st</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Second paragraph</p>
+<p>2nd</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Third paragraph</p>
+<p>3rd</p>
 <!-- /wp:paragraph -->"
 `;
 
 exports[`block editor keyboard shortcuts move blocks single block selected should move the block up 2`] = `
 "<!-- wp:paragraph -->
-<p>Third paragraph</p>
+<p>3rd</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>First paragraph</p>
+<p>1st</p>
 <!-- /wp:paragraph -->
 
 <!-- wp:paragraph -->
-<p>Second paragraph</p>
+<p>2nd</p>
+<!-- /wp:paragraph -->"
+`;
+
+exports[`block editor keyboard shortcuts test shortcuts handling through portals in the same tree should prevent deleting multiple selected blocks from inputs 1`] = `
+"<!-- wp:paragraph -->
+<p>1st</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:paragraph -->
+<p>2nd</p>
+<!-- /wp:paragraph -->
+
+<!-- wp:paragraph -->
+<p>3rd</p>
 <!-- /wp:paragraph -->"
 `;

package/specs/editor/various/block-editor-keyboard-shortcuts.test.js

@@ -6,15 +6,18 @@ import {
 	clickBlockAppender,
 	getEditedPostContent,
 	pressKeyWithModifier,
+	clickBlockToolbarButton,
+	clickMenuItem,
+	clickOnCloseModalButton,
 } from '@wordpress/e2e-test-utils';
 
 const createTestParagraphBlocks = async () => {
 	await clickBlockAppender();
-	await page.keyboard.type( 'First paragraph' );
+	await page.keyboard.type( '1st' );
 	await page.keyboard.press( 'Enter' );
-	await page.keyboard.type( 'Second paragraph' );
+	await page.keyboard.type( '2nd' );
 	await page.keyboard.press( 'Enter' );
-	await page.keyboard.type( 'Third paragraph' );
+	await page.keyboard.type( '3rd' );
 };
 
 describe( 'block editor keyboard shortcuts', () => {
@@ -66,4 +69,41 @@ describe( 'block editor keyboard shortcuts', () => {
 			} );
 		} );
 	} );
+	describe( 'test shortcuts handling through portals in the same tree', () => {
+		beforeEach( async () => {
+			await createTestParagraphBlocks();
+			// Multiselect via keyboard.
+			await pressKeyWithModifier( 'primary', 'a' );
+			await pressKeyWithModifier( 'primary', 'a' );
+		} );
+		it( 'should propagate properly and delete selected blocks', async () => {
+			await clickBlockToolbarButton( 'Options' );
+			const label = 'Duplicate';
+			await page.$x(
+				`//div[@role="menu"]//span[contains(concat(" ", @class, " "), " components-menu-item__item ")][contains(text(), "${ label }")]`
+			);
+			await page.keyboard.press( 'Delete' );
+			expect( await getEditedPostContent() ).toMatchInlineSnapshot(
+				`""`
+			);
+		} );
+		it( 'should prevent deleting multiple selected blocks from inputs', async () => {
+			await clickBlockToolbarButton( 'Options' );
+			await clickMenuItem( 'Add to Reusable blocks' );
+			const reusableBlockNameInputSelector =
+				'.reusable-blocks-menu-items__convert-modal .components-text-control__input';
+			const nameInput = await page.waitForSelector(
+				reusableBlockNameInputSelector
+			);
+			await nameInput.click();
+			await page.keyboard.type( 'hi' );
+			await page.keyboard.press( 'Backspace' );
+			await page.keyboard.press( 'ArrowLeft' );
+			await page.keyboard.press( 'Delete' );
+			await clickOnCloseModalButton(
+				'.reusable-blocks-menu-items__convert-modal'
+			);
+			expect( await getEditedPostContent() ).toMatchSnapshot();
+		} );
+	} );
 } );

package/specs/editor/various/font-size-picker.test.js

@@ -7,7 +7,6 @@ import {
 	createNewPost,
 	pressKeyWithModifier,
 	pressKeyTimes,
-	activateTheme,
 	openTypographyToolsPanelMenu,
 } from '@wordpress/e2e-test-utils';
 
@@ -100,21 +99,68 @@ describe( 'Font Size Picker', () => {
 		` );
 		} );
 	} );
+
 	// A different control is rendered based on the available font sizes number.
 	describe( 'More font sizes', () => {
-		beforeAll( async () => {
-			await activateTheme( 'tt1-blocks' );
-		} );
-		afterAll( async () => {
-			await activateTheme( 'twentytwentyone' );
+		beforeEach( async () => {
+			await page.evaluate( () => {
+				wp.data.dispatch( 'core/block-editor' ).updateSettings(
+					// eslint-disable-next-line no-undef
+					lodash.merge(
+						wp.data.select( 'core/block-editor' ).getSettings(),
+						{
+							__experimentalFeatures: {
+								typography: {
+									fontSizes: {
+										default: [
+											{
+												name: 'Tiny',
+												slug: 'tiny',
+												size: '11px',
+											},
+											,
+											{
+												name: 'Small',
+												slug: 'small',
+												size: '13px',
+											},
+											{
+												name: 'Medium',
+												slug: 'medium',
+												size: '20px',
+											},
+											{
+												name: 'Large',
+												slug: 'large',
+												size: '36px',
+											},
+											{
+												name: 'Extra Large',
+												slug: 'x-large',
+												size: '42px',
+											},
+											{
+												name: 'Huge',
+												slug: 'huge',
+												size: '48px',
+											},
+										],
+									},
+								},
+							},
+						}
+					)
+				);
+			} );
 		} );
+
 		it( 'should apply a named font size using the font size buttons', async () => {
 			// Create a paragraph block with some content.
 			await clickBlockAppender();
 			await page.keyboard.type( 'Paragraph to be made "large"' );
 
 			await openFontSizeSelectControl();
-			await pressKeyTimes( 'ArrowDown', 4 );
+			await pressKeyTimes( 'ArrowDown', 5 );
 			await page.keyboard.press( 'Enter' );
 
 			expect( await getEditedPostContent() ).toMatchInlineSnapshot( `
@@ -131,11 +177,11 @@ describe( 'Font Size Picker', () => {
 			);
 
 			await openFontSizeSelectControl();
-			await pressKeyTimes( 'ArrowDown', 3 );
+			await pressKeyTimes( 'ArrowDown', 4 );
 			await page.keyboard.press( 'Enter' );
 			expect( await getEditedPostContent() ).toMatchInlineSnapshot( `
-			"<!-- wp:paragraph {\\"fontSize\\":\\"normal\\"} -->
-			<p class=\\"has-normal-font-size\\">Paragraph with font size reset using tools panel menu</p>
+			"<!-- wp:paragraph {\\"fontSize\\":\\"medium\\"} -->
+			<p class=\\"has-medium-font-size\\">Paragraph with font size reset using tools panel menu</p>
 			<!-- /wp:paragraph -->"
 		` );
 
@@ -158,7 +204,7 @@ describe( 'Font Size Picker', () => {
 			);
 
 			await openFontSizeSelectControl();
-			await pressKeyTimes( 'ArrowDown', 2 );
+			await pressKeyTimes( 'ArrowDown', 3 );
 			await page.keyboard.press( 'Enter' );
 			expect( await getEditedPostContent() ).toMatchInlineSnapshot( `
 			"<!-- wp:paragraph {\\"fontSize\\":\\"small\\"} -->

package/specs/editor/various/post-editor-template-mode.test.js

@@ -102,7 +102,7 @@ describe( 'Post Editor Template mode', () => {
 	} );
 
 	it( 'Allow to switch to template mode, edit the template and check the result', async () => {
-		await activateTheme( 'tt1-blocks' );
+		await activateTheme( 'emptytheme' );
 		await createNewPost();
 		// Create a random post.
 		await page.type( '.editor-post-title__input', 'Just an FSE Post' );

package/specs/editor/various/preview.test.js

@@ -204,7 +204,7 @@ describe( 'Preview', () => {
 	it( 'should not revert title during a preview right after a save draft', async () => {
 		const editorPage = page;
 
-		// Type aaaaa in the title filed.
+		// Type aaaaa in the title field.
 		await editorPage.type( '.editor-post-title__input', 'aaaaa' );
 		await editorPage.keyboard.press( 'Tab' );
 
@@ -248,6 +248,71 @@ describe( 'Preview', () => {
 
 		await previewPage.close();
 	} );
+
+	// Verify correct preview. See: https://github.com/WordPress/gutenberg/issues/33616
+	it( 'should display the correct preview when switching between published and draft statuses', async () => {
+		const editorPage = page;
+
+		// Type Lorem in the title field.
+		await editorPage.type( '[aria-label="Add title"]', 'Lorem' );
+
+		// Open the preview page.
+		const previewPage = await openPreviewPage( editorPage );
+		await previewPage.waitForSelector( '.entry-title' );
+
+		// Title in preview should match input.
+		let previewTitle = await previewPage.$eval(
+			'.entry-title',
+			( node ) => node.textContent
+		);
+		expect( previewTitle ).toBe( 'Lorem' );
+
+		// Return to editor and publish post.
+		await editorPage.bringToFront();
+		await publishPost();
+
+		// Close the panel.
+		await page.waitForSelector( '.editor-post-publish-panel' );
+		await page.click( '.editor-post-publish-panel__header button' );
+
+		// Change the title and preview again.
+		await editorPage.type( '[aria-label="Add title"]', ' Ipsum' );
+		await editorPage.keyboard.press( 'Tab' );
+		await waitForPreviewDropdownOpen( editorPage );
+		await waitForPreviewNavigation( previewPage );
+
+		// Title in preview should match updated input.
+		previewTitle = await previewPage.$eval(
+			'.entry-title',
+			( node ) => node.textContent
+		);
+
+		expect( previewTitle ).toBe( 'Lorem Ipsum' );
+
+		// Return to editor and switch to Draft.
+		await editorPage.bringToFront();
+		await editorPage.waitForSelector( '.editor-post-switch-to-draft' );
+		await editorPage.click( '.editor-post-switch-to-draft' );
+		await page.keyboard.press( 'Enter' );
+
+		// Change the title.
+		await editorPage.type( '[aria-label="Add title"]', 'Draft ' );
+		await editorPage.keyboard.press( 'Tab' );
+
+		// Open the preview page.
+		await waitForPreviewDropdownOpen( editorPage );
+		await waitForPreviewNavigation( previewPage );
+
+		// Title in preview should match updated input.
+		previewTitle = await previewPage.$eval(
+			'.entry-title',
+			( node ) => node.textContent
+		);
+
+		expect( previewTitle ).toBe( 'Draft Lorem Ipsum' );
+
+		await previewPage.close();
+	} );
 } );
 
 describe( 'Preview with Custom Fields enabled', () => {

package/specs/editor/various/reusable-blocks.test.js

@@ -15,6 +15,7 @@ import {
 	openDocumentSettingsSidebar,
 	saveDraft,
 	createReusableBlock,
+	publishPost,
 } from '@wordpress/e2e-test-utils';
 
 const reusableBlockNameInputSelector =
@@ -23,11 +24,22 @@ const reusableBlockInspectorNameInputSelector =
 	'.block-editor-block-inspector .components-text-control__input';
 
 const saveAll = async () => {
-	await page.click( '.editor-post-publish-button__button.has-changes-dot' );
-	await page.waitForSelector(
-		'button.editor-entities-saved-states__save-button'
+	const publishButtonSelector =
+		'.editor-post-publish-button__button.has-changes-dot';
+	// Wait for the Publish button to become enabled in case the editor is autosaving ATM:
+	const publishButton = await page.waitForSelector(
+		publishButtonSelector + '[aria-disabled="false"]'
 	);
-	await page.click( 'button.editor-entities-saved-states__save-button' );
+	await publishButton.click();
+
+	const saveButtonSelector =
+		'button.editor-entities-saved-states__save-button';
+	const saveButton = await page.waitForSelector( saveButtonSelector );
+	await saveButton.click();
+};
+
+const saveAllButDontPublish = async () => {
+	await saveAll();
 
 	// no need to publish the post.
 	const cancelPublish = await page.waitForSelector(
@@ -81,7 +93,7 @@ describe( 'Reusable blocks', () => {
 		await page.keyboard.type( 'Oh! ' );
 
 		// Save the reusable block
-		await saveAll();
+		await saveAllButDontPublish();
 
 		// Check that its content is up to date
 		const text = await page.$eval(
@@ -112,6 +124,41 @@ describe( 'Reusable blocks', () => {
 		expect( paragraphContent ).toMatch( 'Oh! Hello there!' );
 	} );
 
+	// Check for regressions of https://github.com/WordPress/gutenberg/issues/33072.
+	it( 'can be saved when modified inside of a published post', async () => {
+		await createReusableBlock(
+			'Guten Berg!',
+			'Alternative greeting block'
+		);
+
+		// Make sure the reusable block has loaded properly before attempting to publish the post.
+		await page.waitForSelector( 'p[aria-label="Paragraph block"]' );
+
+		await publishPost();
+
+		// Close publish panel.
+		const closePublishPanelSelector =
+			'.editor-post-publish-panel__header button[aria-label="Close panel"]';
+		await page.waitForSelector( closePublishPanelSelector );
+		await page.click( closePublishPanelSelector );
+
+		await page.waitForSelector( 'p[aria-label="Paragraph block"]' );
+		await page.focus( 'p[aria-label="Paragraph block"]' );
+
+		// Change the block's content
+		await page.keyboard.type( 'Einen ' );
+
+		// Save the reusable block and update the post
+		await saveAll();
+
+		// Check that its content is up to date
+		const paragraphContent = await page.$eval(
+			'p[aria-label="Paragraph block"]',
+			( element ) => element.innerText
+		);
+		expect( paragraphContent ).toMatch( 'Einen Guten Berg!' );
+	} );
+
 	it( 'can be inserted after refresh', async () => {
 		await createReusableBlock( 'Awesome Paragraph', 'Awesome block' );
 

package/specs/editor/various/undo.test.js

@@ -420,4 +420,25 @@ describe( 'undo', () => {
 		// Expect "1".
 		expect( await getEditedPostContent() ).toMatchSnapshot();
 	} );
+
+	it( 'should be able to undo and redo when transient changes have been made and we update/publish', async () => {
+		// Typing consecutive characters in a `Paragraph` block updates the same
+		// block attribute as in the previous action and results in transient edits
+		// and skipping `undo` history steps.
+		const text = 'tonis';
+		await clickBlockAppender();
+		await page.keyboard.type( text );
+		await publishPost();
+		await pressKeyWithModifier( 'primary', 'z' );
+		expect( await getEditedPostContent() ).toBe( '' );
+		await page.waitForSelector(
+			'.editor-history__redo[aria-disabled="false"]'
+		);
+		await page.click( '.editor-history__redo[aria-disabled="false"]' );
+		expect( await getEditedPostContent() ).toMatchInlineSnapshot( `
+		"<!-- wp:paragraph -->
+		<p>tonis</p>
+		<!-- /wp:paragraph -->"
+	` );
+	} );
 } );

package/specs/performance/site-editor.test.js

@@ -31,7 +31,7 @@ jest.setTimeout( 1000000 );
 
 describe( 'Site Editor Performance', () => {
 	beforeAll( async () => {
-		await activateTheme( 'tt1-blocks' );
+		await activateTheme( 'emptytheme' );
 		await trashAllPosts( 'wp_template' );
 		await trashAllPosts( 'wp_template', 'auto-draft' );
 		await trashAllPosts( 'wp_template_part' );

package/specs/site-editor/document-settings.test.js

@@ -26,7 +26,7 @@ async function getDocumentSettingsSecondaryTitle() {
 
 describe( 'Document Settings', () => {
 	beforeAll( async () => {
-		await activateTheme( 'tt1-blocks' );
+		await activateTheme( 'emptytheme' );
 		await trashAllPosts( 'wp_template' );
 		await trashAllPosts( 'wp_template_part' );
 	} );
@@ -43,7 +43,7 @@ describe( 'Document Settings', () => {
 		it( 'should display the selected templates name in the document header', async () => {
 			// Navigate to a template
 			await siteEditor.visit( {
-				postId: 'tt1-blocks//index',
+				postId: 'emptytheme//index',
 				postType: 'wp_template',
 			} );
 
@@ -64,7 +64,7 @@ describe( 'Document Settings', () => {
 				);
 				headerTemplatePartListViewButton.click();
 				await page.click(
-					'button[aria-label="Close list view sidebar"]'
+					'button[aria-label="Close List View Sidebar"]'
 				);
 
 				// Evaluate the document settings secondary title
@@ -79,7 +79,7 @@ describe( 'Document Settings', () => {
 		it( "should display the selected template part's name in the document header", async () => {
 			// Navigate to a template part
 			await siteEditor.visit( {
-				postId: 'tt1-blocks//header',
+				postId: 'emptytheme//header',
 				postType: 'wp_template_part',
 			} );
 

package/specs/site-editor/multi-entity-editing.test.js

@@ -134,7 +134,7 @@ const removeErrorMocks = () => {
 
 describe( 'Multi-entity editor states', () => {
 	beforeAll( async () => {
-		await activateTheme( 'tt1-blocks' );
+		await activateTheme( 'emptytheme' );
 		await trashAllPosts( 'wp_template' );
 		await trashAllPosts( 'wp_template_part' );
 	} );
@@ -152,7 +152,7 @@ describe( 'Multi-entity editor states', () => {
 	// Skip reason: This should be rewritten to use other methods to switching to different templates.
 	it.skip( 'should not dirty an entity by switching to it in the template dropdown', async () => {
 		await siteEditor.visit( {
-			postId: 'tt1-blocks//header',
+			postId: 'emptytheme//header',
 			postType: 'wp_template_part',
 		} );
 		await page.waitForFunction( () =>

package/specs/site-editor/multi-entity-saving.test.js

@@ -46,7 +46,7 @@ describe( 'Multi-entity save flow', () => {
 	let originalSiteTitle, originalBlogDescription;
 
 	beforeAll( async () => {
-		await activateTheme( 'tt1-blocks' );
+		await activateTheme( 'emptytheme' );
 		await trashAllPosts( 'wp_template' );
 		await trashAllPosts( 'wp_template_part' );
 		await trashAllPosts( 'wp_block' );
@@ -165,6 +165,11 @@ describe( 'Multi-entity save flow', () => {
 				'//*[@id="a11y-speak-polite"][contains(text(), "Post published")]'
 			);
 
+			// Unselect the blocks to avoid clicking the block toolbar.
+			await page.evaluate( () => {
+				wp.data.dispatch( 'core/block-editor' ).clearSelectedBlock();
+			} );
+
 			// Update the post.
 			await page.click( '.editor-post-title' );
 			await page.keyboard.type( '...more title!' );
@@ -259,7 +264,7 @@ describe( 'Multi-entity save flow', () => {
 		it( 'Save flow should work as expected', async () => {
 			// Navigate to site editor.
 			await siteEditor.visit( {
-				postId: 'tt1-blocks//index',
+				postId: 'emptytheme//index',
 				postType: 'wp_template',
 			} );
 			await siteEditor.disableWelcomeGuide();
@@ -270,7 +275,7 @@ describe( 'Multi-entity save flow', () => {
 				'//a[contains(@class, "block-editor-list-view-block-select-button")][contains(., "Header")]'
 			);
 			headerTemplatePartListViewButton.click();
-			await page.click( 'button[aria-label="Close list view sidebar"]' );
+			await page.click( 'button[aria-label="Close List View Sidebar"]' );
 
 			// Insert something to dirty the editor.
 			await insertBlock( 'Paragraph' );
@@ -297,7 +302,7 @@ describe( 'Multi-entity save flow', () => {
 		it( 'Save flow should allow re-saving after changing the same block attribute', async () => {
 			// Navigate to site editor.
 			await siteEditor.visit( {
-				postId: 'tt1-blocks//index',
+				postId: 'emptytheme//index',
 				postType: 'wp_template',
 			} );
 			await siteEditor.disableWelcomeGuide();
@@ -308,26 +313,18 @@ describe( 'Multi-entity save flow', () => {
 			// Open the block settings.
 			await page.click( 'button[aria-label="Settings"]' );
 
-			// Click on font size selector.
-			await page.click( 'button[aria-label="Font size"]' );
-
-			// Click on a different font size.
-			const extraSmallFontSize = await page.waitForXPath(
-				'//li[contains(text(), "Extra small")]'
+			// Change the font size
+			await page.click(
+				'.components-font-size-picker__controls button[aria-label="Small"]'
 			);
-			await extraSmallFontSize.click();
 
 			// Save all changes.
 			await saveAllChanges();
 
-			// Click on font size selector again.
-			await page.click( 'button[aria-label="Font size"]' );
-
-			// Select another font size.
-			const normalFontSize = await page.waitForXPath(
-				'//li[contains(text(), "Normal")]'
+			// Change the font size
+			await page.click(
+				'.components-font-size-picker__controls button[aria-label="Medium"]'
 			);
-			await normalFontSize.click();
 
 			// Assert that the save button has been re-enabled.
 			const saveButton = await page.waitForSelector(